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Kapitel 0 Tutorial 


1. Einfuhrung in REALbasic 
Willkommen bei REALbasic 


REALbasic ist eine integrierte Entwicklungsumgebung, die auf einer modernen Form der BASIC-Programmiersprache 
basiert. Die REALbasic Entwicklungsumgebung beinhaltet eine objektorientierte Programmiersprache, einen 
Objekt-Browser, einen Quelltext-Debugger und eine umfangreiche Sammlung von Objekten zum Programmieren grafi- 
scher Benutzeroberflachen (Graphical User Interface, GUI). 


Damit stellt REALbasic alle Werkzeuge zur Verfiigung, die Sie zum Entwickeln beliebiger Anwendungen benotigen. 


Einsteiger werden viel Freude daran haben, Mac OS-, Windows- und Linux-Programme mit REALbasic zu entwickeln, die 
alle modernen Funktionen des Betriebssystems nutzen k6nnen. 


Fortgeschrittene und erfahrene Programmierer werden vor allem den grofsen Umfang und die Qualitit der in REALbasic 
integrierten Werkzeuge zu schatzen wissen. 


Wie man dieses Tutorial benutzt 


Dieses Tutorial bietet eine Reihe von praktischen Ubungen, um REALbasic kennenzulernen. Die Lektionen sind so struk- 
turiert, dass jede innerhalb einer halben Stunde absolviert werden kann. Da jedes Kapitel auf dem vorigen aufsetzt, soll- 
ten Sie das Tutorial in der richtigen Reihenfolge durcharbeiten. 


Im Tutorial werden Sie mit REALbasic ein vollstandiges Programm entwickeln. Sie werden einen Texteditor programmie- 
ren, der SimpleText, dem Texteditor, der mit Macintosh-Computern mitgeliefert wird, ahnlich ist. Mit REALbasic sind Sie 
in der Lage, Programme fiir das ,,klassische“ Mac OS, Mac OS X, Windows und Linux zu compilieren. 

Sie werden schnell die Fahigkeiten und die leichte Bedienbarkeit von REALbasic schatzen lernen. Ftir das gesamte Pro- 
gramm werden Sie nur ungefahr 200 Zeilen schreiben miissen, wahrend SimpleText im Original aus etwa 20000 Zeilen C/ 
C++ Code besteht. 


Wer dieses Tutorial benutzen sollte 


Dieses Tutorial wurde fiir Programmiereinsteiger geschrieben. Sie miissen keinerlei Wissen tiber das Programmieren 
mitbringen, um das Tutorial durchzuarbeiten. 


Wenn Sie schon iiber Programmiererfahrung verfiigen, sollten Sie dieses Tutorial tiberfliegen, um sich einen Uberblick 
iiber die IDE (Integrated Development Environment, integrierte Entwicklungsumgebung) von REALbasic und tiber die 
Sprachfunktionen zu verschaffen. 


Weitere Hinweise 


Kursive Schrift wird verwendet, wenn ein Ausdruck zum ersten Mal gebraucht wird und um wichtige Konzepte hervor- 
zuheben. Kursive Schrift wird auSerdem fiir Buchtitel, wie z.B REALbasic Entwicklerbandbuch, eingesetzt. 


Manchmal miissen Sie im Laufe des Tutorials Code-Zeilen in den Code-Editor eintippen. Diese werden mit einem unpro- 
portionalen Font hervorgehoben: 
for i=1 to 10 
a(i)=i 
next 
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Wenn Sie Code eintippen, beachten Sie bitte folgende Regeln: 

© Tippen Sie jede abgedruckte Zeile in eine eigene Zeile im Code-Editor. Versuchen Sie nicht, zwei oder mehr Zeilen zu 
vereinigen oder eine lange Zeile auf zwei oder mehr Zeilen zu verteilen. 

@ Fiigen Sie keine extra Leerzeichen ein, wo sich keine befinden. 

Immer wenn Sie Ihr Programm starten, wird REALbasic zuerst die Syntax Ihres Programmtextes tiberpriifen. Die Syntax- 

iiberpriifung wird Sie direkt auf die Zeile hinweisen, in der ein Problem auftritt. Vergleichen Sie diese Zeile mit der hier 

im Handbuch abgedruckten. Ebenso kénnen Sie, falls es Probleme gibt, die zum Kapitel gehdrige Quelltextdatei laden 

und den Code-Teil an entsprechender Stelle einfiigen. 


Tutorial-Dateien 


Alle zum Tutorial zugehGrigen Dateien finden Sie auf der CD im Ordner Tutorial Projekt. Sie konnen Ihre Arbeit an 
beliebiger Stelle im Tutorial mit den beigeftigten Dateien vergleichen. Sie konnen ebenso ein neues Kapitel mit der ferti- 
gen Datei des vorigen Kapitels auf der CD beginnen. 


Da fiir jedes Kapitel eine vollstandige Projektdatei mitgeliefert wird, konnen Sie auch ein Kapitel tiberspringen, falls Sie 
darauf gerade keine Lust haben. Spater konnen Sie das Ausgelassene immer noch aufarbeiten. 


Deutsche Ubersetzung 


In diesem Handbuch wurde nicht mit Gewalt jeder Begriff ins Deutsche tibersetzt. Englische Begriffe, die sich etabliert 
haben und fiir die es keine passende Ubersetzung gibt, wurden so belassen (Code, Editor, Browser). Sie werden also 
nicht Flag durch Flagge und Key durch Schliissel ersetzt finden. 


Leider gibt es einige Stellen, an denen wir selbst unschliissig waren, ob es nun besser ist, den englischen oder den deut- 
schen Begriff zu verwenden. Meistens sprechen ebenso viele Argumente daftir wie dagegen. Wir bitten Sie daher, grofs- 
ziigig dartiber hinwegzusehen, wenn Sie meinen, eine inkonsequente Haltung unsererseits entdeckt zu haben. 


Auf die Platze, fertig, los! 


Sie sind nun bereit, mit dem Lernen von REALbasic zu beginnen. 


2. Das Erzeugen von Fenstern 


In diesem Kapitel erhalten Sie eine Einftihrung in REALbasic und seine integrierte Entwicklungsumgebung (IDE). 
Sie werden erfahren, 

© wie man REALbasic startet, 

welche Fenster zur Entwicklungsumgebung von REALbasic gehGren, 

wie man ein Dokument-Fenster erzeugt, das den Text des Texteditors aufnehmen wird, 

© wie man das selbstgeschriebene Programm startet. 


REALbasic starten 


Suchen Sie das REALbasic-Programm-Icon auf Ihrem Desktop (es befindet sich in dem Ordner, in dem Sie 
REALbasic installiert haben) und starten Sie es durch Doppelklick. 
REAL basic 
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Nachdem Sie REALbasic gestartet haben, sollte Ihr Bildschirm unter Mac OS X etwa so aussehen: 
Fenster-Editor Eigenschaften-Fenster 


Projekt-Fenster Steuerelemente-Palette 


" @_REALbasic |Ablage Bearbeiten Format Debug |Fenster Extras Hilfe = 


MinHeight: 64 
‘Maxwidth; 32000 
MaxHeight: 32000 


Backdrop: Keins 
Title: Namenlos 


BalloonHelp: 
‘MacProciD: 0 


Wenn Sie eine altere Mac OS-Version verwenden, wird Ihr Bildschirm ein wenig anders aussehen. 
Falls Sie REALbasic fiir Windows verwenden, sieht der Bildschirm nach dem Start von REALbasic ungefahr so aus: 
Steuerelemente-Palette 


Projekt-Fenster Fenster-Editor Eigenschaften-Fenster 


ester Extras Hie 


{. [O)X| © Namentos 


jeriileistel ow 


Die REALbasic-Fenster 


Wie Sie im Bild sehen kénnen, hat REALbasic nach dem Start vier Fenster ge6ffnet: 


© Das Projekt-Fenster enthilt eine Liste aller Teile Ihres REALbasic-Programms. 

© Fenster-Editor ist der Oberbegriff fiir ein Applikationsfenster in der Entwicklungsumgebung. Den Namen eines spezi- 
ellen Fensters finden Sie in der Name-Eigenschaft im Eigenschaften-Fenster. 

® Die Steuerelemente-Palette enthilt Icons, die Interface-Objekte reprasentieren, die Sie per Drag & Drop in den Fen- 
ster-Editor ziehen kénnen, um die Interface-Objekte Ihrer Applikation zu erzeugen. Interface-Objekte werden in 
REALbasic als Steuerelemente bezeichnet. 
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© Das Eigenschaften-Fenster enthilt eine Liste aller Eigenschaften und deren Werte ftir das aktuell selektierte Objekt 
Threr Applikation. Wenn Sie ein anderes Objekt selektieren, andert sich das Eigenschaften-Fenster, um die Eigen- 
schaften des neu selektierten Objektes darzustellen. Ist kein Objekt selektiert, bleibt das Eigenschaften-Fenster leer. 


Zusatzlich knnen Sie folgende Fenster 6ffnen: 


© Das Farben-Fenster wird benutzt, um selbstdefinierte Farben zu speichern, die Sie in Ihrem Pro- 
gramm verwenden mdchten. Es besteht aus einer Palette von bis zu 16 Farben. Sie konnen einem 
Palettenelement eine Farbe zuweisen, indem Sie auf dieses klicken. Dann erscheint die Farbaus- 
wahl. Um einer Objekteigenschaft eine Farbe zuzuweisen, draggen Sie eine Farbe aus dem Far- 
ben-Fenster auf den Wert einer Eigenschaft, die eine Farbe akzeptiert, wie z.B. die 
BackColor-Eigenschaft eines Fenster-Objektes. 

© Das Sprachreferenz-Fenster mit dem Online-Referenzhandbuch, das Sie tiber den Mentipunkt Hilfe/Sprachrefe- 
renz aufrufen. Dabei handelt es sich um eine bequeme Alternative zur gedruckten bzw. elektronischen (PDF-) Ver- 
sion der Sprachreferenz. Das Entwicklerhandbuch ist nicht Teil dieser Hilfe-Datei, Sie konnen sich aber die 
PDF-Version auf dem Bildschirm jederzeit anzeigen lassen. 


© Farben 


e608 _ Sprachreferenz : 
(«| 9 [@) Co) 
Alpha” THEMEN | Window Funktion 


> 3D-Grafiken 
> AppleEvents 


Liefert eine Referenz auf ein offenes Fenster. 


Syntax 

Db Arrays Ergebnis-Window(WindowNumber) 
> Boolean Teil Art Beschreibung 
» Code-Ausfiihrung Ergebnis Window Eine Referenz auf ein Fenster, dessen Nummer 
> Dateien ibergeben wurde. 

WindowNumber Integer Die Nummer des Fensters, zu dem Sie eine Referenz 
pe Davenbane haben machten. 
> Datentypen Hinweis 
> Datum und Uhrzei Die Funktion Window liefert eine Referenz auf das Fenster. Das Fenster 0 (Null) ist hierbei das vorderste Fenster. 
> Debugging Diese Funktion kann in Verbindung mit der Funktion WindowCount verwendet werden, um nacheinander alle offenen 

Fenster zu bearbeiten. 
» Drucken 

| Beispiel 


¥ Einfahrung 


Cross-Plattform... _Dieses Beispiel legt die Titel aller besectdl eine ListBox: 
Dim Tas Integer 

Die Klassen-tie... | Dim windowTitle as String 

Hilfe If WindowCount > 1 then 

Konventionen | For i=@ to WindowCount-1 

Uberblick | WindowTitLe-Window(i).Title 


ListBox1.AddRow windowTitle 


> Fehlerbehandiung text 


> Fehlermeldungen 
¥ Fenster 


Parca 


meranen . WindowCount -Funktion, Window Klasse. a 
Applet-Klasse | < 
ClearFocus Met... y 
Erzeugen eines Dokument-Fensters 2 ae 
Name: TextFenster 
Wenn Sie REALbasic starten, 6ffnet es zundchst ein leeres Fenster in einem Fenster-Editor. Super: Window y 
Der Name dieses Fensters ist Fenster1 und wird im Projekt-Fenster aufgeftihrt, die Eigen- Placement: 0 Standard Y 
schaften des Fensters werden im Eigenschaften-Fenster aufgelistet. Da dies das Fenster ist, Se 
das spater den Texteditor enthalten wird, werden Sie ihm zundchst einen aussagekraftige. un Ft 
ren Namen geben: eee 
1. Klicken Sie auf Fenster1 im Projektfenster. Das Eigenschaften-Fenster zeigt daraufhin Frame: 0-Dokumentfenster _-¥ 
die aktuellen Eigenschaften von Fenster]. eee 
2. Andern Sie die Eigenschaft Name im Eigenschaften-Fenster in TextFenster. Selektie- SS = = 


Visible: 


ren Sie dazu mit der Maus den Begriff Fenster1, tippen Sie TextFenster und driicken Fullscreen: 


‘ MenuBarVisible 
Sie Return. Closetox: 
Dabei dndert sich auch im Projekt-Fenster der Name von Fenster1 in TextFenster. ee = 
Als nachstes miissen Sie dafiir sorgen, dass man das Fenster spater auch in der GrofSe —_Baleenttelo e 


MacProciD: 0 


andern kann. 
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3. Aktivieren Sie dazu die Checkbox hinter Growlcon im Eigenschaften-Fenster: 


Hinzufiigen eines EditField-Objektes 


Damit unser TextFenster auch Text aufnehmen kann, benutzen Sie ein Steuerelement namens EditField aus der Steuere- 
lemente-Palette. Das ist das Interface-Objekt, das Texteingaben vom Anwender entgegennimmt. Das EditField-Steuere- 
lement sieht folgendermafsen aus: 


EditField 


«tv 


Um ein EditField in das TextFenster einzufiigen, mtissen Sie folgendermafsen vorgehen: 


1. Wenn das TextFenster noch nicht im Fenster-Editor ge6ffnet ist, 6ffnen Sie es mit einem Eigenschaften 
Doppelklick im Projekt-Fenster. Name: TextFeld 


EditField 


2. Nehmen Sie das EditField in der Steuerelemente-Palette und ziehen Sie es per 
Drag & Drop in unser TextFenster. Da das EditField nun das aktuell selektierte Objekt ist, 


ControlOrder: 
Left: 20 


werden im Eigenschaften-Fenster seine Eigenschaften angezeigt. Top: 14 
Sie verwenden die Steuerelemente der Steuerelemente-Palette als Vorlage fiir Ihre Inter- site oe 
face-Objekte. Wenn Sie ein Steuerelement aus der Steuerelemente-Palette in ein Fenster ee 


ziehen, erzeugt REALbasic ein Objekt, das auf dieser Vorlage basiert. Dieses Objekt ‘es = 
bekommt automatisch all die Eigenschaften, die zu der Vorlage gehGren. Diese Eigen- =_ 
schaften werden im Eigenschaften-Fenster angezeigt. MultLine: 


ScroliBarHorizontal () 
ScrollBarVertical 


3. Benutzen Sie das Eigenschaften-Fenster, um die Eigenschaft Name des EditField-Objek- Soe 
tes von EditField1 in TextFeld zu dndern. Password 


UseFocusRing: 
TextColor: 


4. Das Eigenschaften-Fenster des EditField-Objektes sollt nun so aussehen, wie nebenan = yee 
Enabled: 


gezeigt. Format re) 

Sie haben zwar erst damit begonnen, Ihre erste REALbasic-Applikation zu programmieren, wae a = 
jelpTag: 

wollen diese aber bestimmt schon mal starten, um zu sehen, was passiert. BalloonHelp re 

DisabledBallo... e 


AutoDeactivate 


5. Wahlen Sie den Mentipunkt Debug/Programm starten. Das TextFenster erscheint und 
sollte etwa so aussehen: 


"ee Namenlos 


| TextFeld 


6. Tippen Sie etwas in das TextFeld, um es zu testen. 

7. Nachdem Sie alles ausprobiert haben, wahlen Sie Mein Programm/Beenden unter Mac OS X oder Datei/Beenden, 
um zur Entwicklungsumgebung zurtickzukehren. 

Wenn Sie Run wahlen, um Ihr Programm zu starten, schaltet REALbasic automatisch in die Runtime-Umgebung um (vor- 

ausgesetzt, es werden keine Syntaxfehler gefunden). Die Runtime-Umgebung verwenden Sie, um Testlaufe Ihres Pro- 
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gramms durchzuftihren und ftir das Debugging (die Fehlersuche). Nachdem Sie Ihr Programm beendet haben, landen 
Sie wieder in der Entwicklungsumgebung. 


Das TextFeld zum Text-Editor umfunktionieren 


Das TextFeld, das Sie gerade erzeugt haben, ist offensichtlich noch kein adaquater Texteditor. Bis jetzt kann das TextFeld 
nur eine kleine Menge Text verarbeiten und das auch nur in einer einzelnen Zeile. Um einen benutzbaren Editor zu 
bekommen, benétigt das TextFeld einen Scrollbalken und muss mehrere Zeilen Text akzeptieren. In diesem Abschnitt 
konfigurieren Sie das TextFeld so, dass es wie ein Texteditor funktioniert und vergr6fern es so, dass seine Ausmafe das 
Fenster ausfiillen. 

Um die linke obere Ecke des TextFeldes an der linken oberen Ecke des TextFensters zu fixieren und das EditField so zu 
vergr6fern, dass es mehrere Zeilen Text aufnehmen kann, gehen Sie wie folgt vor: 


1. Klicken Sie auf das TextFeld, um es zu selektieren, falls es noch nicht selektiert ist. Sie sehen rechts im Eigenschaf- 
ten-Fenster, dass der Name des selektierten Objekts TextFeld ist (wichtig!). 


2. Suchen Sie im Eigenschaften-Fenster die Top- und Left-Eigenschaften (oben bzw. links). Selektieren Sie den Wert, 
der fiir die Left-Eigenschaft zustindig ist und tippen Sie dort -1 ein (der urspriingliche Wert verschwindet dadurch). 
Driicken Sie die Return-Taste, um der Eigenschaft den neuen Wert zuzuweisen. 

Dadurch wird das TextFeld an die linke Seite des TextFensters bewegt. Der Wert -1 setzt die linke Ecke des Edit- 
Field-Objektes genau auerhalb des Rahmens des TextFensters. Im Eigenschaften-Fenster werden negative Werte zur 
besseren Erkennung in rot dargestellt. 


3, Wiederholen Sie Schritt 2 fiir die Top-Eigenschaft. Andern Sie auch diesen Wert auf -1. 
Das TextFeld ist nun mit dem oberen und linken Rand des Fensters ausgerichtet: 
@ O © Aamentos 


4. Draggen Sie nun die rechte untere Ecke des TextFeldes (den kleinen schwarzen Punkt) so weit nach rechts unten, 
dass es an den Vergroerungsknopf des TextFensters anstoft. 


5. Um die rechte Seite des TextFeldes an die rechte Seite des TextFensters anzugleichen, draggen Sie den Vergr6fe- 
rungsknopf des TextFensters an die entsprechende Position. Das TextFenster sollte nun folgendermafSen aussehen: 
OOO Aamenios 


Als nachstes miissen Sie REALbasic mitteilen, dass das TextFeld so viele Textzeilen akzeptieren soll, wie der Anwender 
eingibt. Ebenso soll ein Scrollbalken angezeigt und der Text immer beim Erreichen des rechten Randes umgebrochen 
werden. Dies erreichen Sie ganz einfach durch Aktivieren der MultiLine-Eigenschaft ftir das TextFeld. 


6. Selektieren Sie die MultiLine-Eigenschaft von TextFeld, indem Sie die entsprechende Checkbox im Eigenschaf- 
ten-Fenster aktivieren. 


2. Das Erzeugen von Fenstern 15 


Das TextFeld hat nun einen Scrollbalken. Das Dokumentfenster sollte nun so aussehen: 
e is) ick Namenlos = 
a) 


Um das Programm erneut zu starten, gehen Sie so vor: 
1. Wahlen Sie Debug/Programm starten. Das TextFenster-Fenster erscheint. 


2. Geben Sie ein paar Zeilen Text ein. 
Wahrend Sie tippen, werden Sie bemerken, dass der Text am Ende der Zeile umgebrochen wird. Sobald Sie genug 
getippt haben, um alle Zeilen des Fensters auszufiillen, wird der Scrollbalken aktiv. Sie konnen den Scrollbalken 
benutzen, um wieder zurtick an den Anfang zu gelangen. 


3. Wenn Sie fertig getippt haben, wahlen Sie Mein Programm/Beenden unter Mac OS X oder Datei/Beenden, um zur 
Entwicklungsumgebung zuriickzukehren. 


4. Sie sollten Ihr Projekt jetzt speichern. Wahlen Sie hierzu Ablage/Sichern (Windows: Datei/Sichern). Speichern Sie 
Thre Projektdatei unter dem Namen TextEditor-Kapitel2. Der Titel des Projekt-Fensters ist nun_ ,/Text- 
Editor-Kapitel2". 

Sollte Ihr Rechner einmal beim Testen Ihres Programms abstiirzen, restauriert REALbasic den urspriinglichen Status 

Ihres Projektes, wenn Sie das Projekt dffnen. Sie miissen also Anderungen nicht andauernd speichern, um zu verhin- 

dern, dass Sie Ihre Arbeit verlieren. 


Schlieflich miissen Sie das TextFeld so konfigurieren, dass es die gleiche Gro&e wie das Fenster annimmt, wenn der 
Benutzer die Fenstergr6fse andert. Wenn Sie dies nicht machen, haben TextFeld und das Fenster nur dann die gleiche 
Gre, wenn der Benutzer die Fenstergr6fe niemals andert (und das ist ziemlich unwahrscheinlich). 


Sie konnen dies austesten, indem Sie in den Laufzeitumgebung wechseln und das Fenster in der Gréfe andern. Das 
sieht dann etwa folgendermatsen aus: 
‘0 Namentos 


Das TextFeld behalt die Grd&e bei, die Sie im Eigenschaften-Fenster festgelegt haben, das Fenster wurde in der Grofse 
jedoch vom Anwender verandert. Jeder Anwender geht eigentlich davon aus, dass der Eingabebereich die gleiche Gre 
besitzt wie das Fenster. 


REALbasic bietet daftir eine einfache Méglichkeit: Die Lock-Eigenschaften (Lock steht fiir Einrasten bzw. Ankoppeln). 
Die Lock-Eigenschaften werden verwendet, um den Abstand der TextFeld- und Fensterecken fest zu definieren. Dieser 
Abstand wird auch bei Gréfendnderungen des Fensters beibehalten, wenn die Lock-Eigenschaften aktiviert sind. 


Um die Gréfe von TextFeld mit der des Fensters zu verbinden, gehen Sie folgendermafsen vor: 
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1. Selektieren Sie das TextFeld. Suchen Sie nach den Eigenschaften LockLeft, LockTop, LockRight und LockBottom 
im Eigenschaften-Fenster und aktivieren Sie diese durch Anklicken der entsprechenden Checkboxen. 


2. Starten Sie Ihr Programm, um die Vergré&erungsfunktion zu testen. 
3. Beenden Sie Ihr Programm, um zur Entwicklungsumgebung zuriickzukehren und speichern Sie Ihr Projekt. 


Bis hierher haben Sie ein sehr niitzliches REALbasic-Objekt erzeugt: TextFenster. TextFenster enthalt mit TextFeld ein 
Objekt, das von der EditField-Klasse abgeleitet und fiir Textbearbeitung konfiguriert wurde. TextFeld hat automatisch alle 
Eigenschaften und Methoden der EditField-Klasse geerbt. Es wurde so konfiguriert, dass es mehrzeilige Texte akzeptiert, 
iiber einen vertikalen Scrollbalken verftigt und seine Grd&e an die des umgebenden Fensters anpasst. Wenn Sie eine wei- 
tere Instanz von TextFenster erzeugen, erhalten Sie alle Eigenschaften von TextFeld ,,kostenlos“ dazu. Diese Tatsache 
werden Sie ausnutzen, wenn Sie im 4. Kapitel den Mentipunkt Ablage/Neu (Windows: Datei/Neu) implementieren. 


Der einfachste Weg, das TextFenster in einem neuen Projekt wiederzuverwenden besteht darin, es aus dem Projekt-Fens- 
ter auf den Desktop (oder in jedes andere Verzeichnis) zu ziehen. Diese Aktion speichert es als exportiertes REAL- 
basic-Objekt. Wenn Sie es in einer anderen Anwendung wiederverwenden mochten, dann ziehen Sie es einfach vom 
Finder in das Projekt-Fenster des anderen Projekts. 


Ruckblick 


In diesem Kapitel haben Sie erfahren, wie man REALbasic startet, welche Fenster es in der Entwicklungsumgebung gibt 
und wie man ein mehrzeiliges EditField in ein Fenster platziert und die eigene Applikation startet. 


3. Erzeugen von Menteintragen 


In diesem Kapitel werden Sie mit Mentis in REALbasic konfrontiert. Sie werden lernen, wie man 
© einer Applikation Meniieintrage hinzufiigt, 
© einen Meniieintrag aktiviert. 


Zum Ausprobieren der Beispiele kGnnen Sie an der Applikation weiterarbeiten, die Sie im 2. Kapitel begonnen haben 
oder die Datei TextEditor-Kapitel2 laden, die Sie im Ordner , Tutorial Projekt“ auf Ihrer CD finden. 


Hinzufiigen eines Alles auswahlen-Mentipunkts 

In dieser Ubung werden Sie dem Bearbeiten-Menii einen Meniipunkt Alles auswahlen hinzufiigen. Hierzu sind fol- 
gende drei Schritte notwendig: 

1. Einfiigen des Meniieintrags in das Bearbeiten-Menii. 


2. Hinzufiigen eines Menu-Handlers, der festlegt, wie REALbasic reagieren soll, wenn der Anwender ein (aktives) Menii 
anwahlt. Der Menu-Handler kann weitere Methoden (Prozesse) aufrufen. 


Hinzufiigen des Menieintrags 

Um einen Meniieintrag Alles auswahlen hinzuzufiigen, gehen Sie folgendermafen vor: 

1. Holen Sie das Projekt-Fenster nach vorne (z.B. durch Fenster/Projekt). 

2. Ftihren Sie einen Doppelklick auf dem Menii-Objekt aus, um den Menii-Editor zu 6ffnen. 


3. Selektieren Sie das Bearbeiten-Menii im Menii-Objekt-Fenster. Das Menti klappt herunter. 
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4. Selektieren Sie den leeren Meniieintrag am Ende der Liste: 


@ © @ Anwendungs-Meni 
: ~«é Ablage Bearbeiten 
Undo Z 


AusschneidenséX 
Kopieren eC 
Einfiigen eV 


Loschen 


Im Menii-Editor ist immer am Ende eines jeden Meniis ein leerer Eintrag. Sie kGnnen diesen verwenden, um neue 
Meniieintrage zu erzeugen. Der leere Eintrag ist eigentlich kein Bestandteil des Mentis und erscheint auch spater 
nicht in der fertigen Applikation. 


Wenn Sie versehentlich einen Mentieintrag hinzugefiigt haben, k6nnen Sie ihn entfernen, indem Sie ihn selektieren 
und Backspace driicken. 


5. Im Eigenschaften-Fenster geben Sie als Text-Eigenschaft Alles auswahlen ein. 


6. Die Name-Eigenschaft wird automatisch mit BearbeitenAllesauswhlen ausgefiillt. Dies andern Sie in Bearbeiten- 
Allesauswaehlen, da Meniinamen keine Sonderzeichen enthalten diirfen. Ebenso sind Leerzeichen nicht erlaubt. 


7. Weisen Sie der CommandKey-Eigenschaft den Buchstaben A zu. 


8. Deselektieren Sie den Schalter AutoEnable. Dieser wiirde bewirken, dass der Mentipunkt automatisch immer aus- 
wahlbar ist. Da er aber nur dann auswahlbar sein soll, wenn ein Textfenster offen ist, miissen wir den Mentipunkt an 
anderer Stelle aktivieren. 


9. Der Menii-Editor und das Eigenschaften-Fenster sollten nun wie folgt aussehen: 


[) Eigenschaften 
@66 _Menileistel Name: BearbeitenAllesAuswaehlen 
@ Ablage Bearbeiten mde 
Widerrufen Super: Menultem v 
Ausschneiden Text: Alles Auswahlen e 
Kopieren Bold: [) 
Einfugen tralic: 
Léschen Underline: 
Alles auswahlen 3A BalloonHielp: e 
DisabledBalloonH... (a) 


~Commandkey: A 
SubMenu: [) 


Das Eigenschaften-Fenster zeigt, dass die tibergeordnete Klasse des Objekts (Super Class — die Klasse, auf der das 
Objekt basiert) ,Menultem‘* ist. Das bedeutet, dass es alle Eigenschaften dieser Klasse erbt und Sie die Eigenschaften 
und Methoden der Menultem-Klasse verwenden kénnen, um den ,,Alles auswahlen“-Meniieintrag zu verwalten. 


10. SchliefSen Sie den Menii-Editor. 


Aktivieren des Menieintrags 


Da der Meniieintrag ,,Alles auswahlen“ mit dem TextFeld in TextFenster in Verbindung steht, fiigen Sie den Code, der 
den Meniieintrag zu aktiviert, in das TextFenster-Objekt ein. Es gibt keinen Grund, den Meniieintrag zu aktivieren, wenn 
kein Fenster offen ist oder kein selektierbarer Text vorhanden ist. 


Die Menultem-Klasse besitzt eine Methode namens Enable, welche die Enable-Eigenschaft des Mentieintrags auf True 
setzt. Dies aktiviert den Mentieintrag ,,Alles auswahlen“ jedesmal, wenn der Anwender ins Bearbeiten-Menti klickt, um 
die dort vorhandenen Meniieintrage anzuzeigen. Um den Meniieintrag ,,Alles auswahlen“ zu aktivieren, gehen Sie fol- 
gendermafen vor: 
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1. Selektieren Sie TextFenster im Projekt-Fenster und driicken Sie alt-Tab, um den Code-Editor zu 6ffnen. 


eee Code Editor (TextFenster) 


> Eigenschaften 

> yp Events 

> Menu-Handler 

> RP Methoden 

> = Notizen | 
b& tg Steuerelemente 


Code-Editor-Browser 


Spaltentrenner 


Hier klicken, um das Fenster 
anzuzeigen, zudemder —- = 
Code-Editor gehort ee Se p<y> 


Im Browser, dem linken Teil des Code-Editor-Fensters, konnen Sie die einzelnen Eintrage durch Klick auf das Dreieck 
vor dem Namen eines Eintrags expandieren und den verschiedenen Events oder Objekten Code hinzuftigen. Aufser- 
dem k6nnen Sie den Browser-Bereich durch Ziehen des Spaltentrenners nach rechts oder links vergr6Sern und ver- 
kleinern. 


. Klicken Sie im Browser auf das Dreieck links vom Events-Icon und selektieren Sie EnableMenultems (eventuell 
miissen Sie den Spaltentrenner nach rechts ziehen, um die Namen aller Events lesen zu k6nnen oder den Scrollbal- 
ken benutzen). Dabei handelt es sich um einen Event-Handler, der immer dann ausgeftihrt wird, wenn sich der 
Anwender die Eintrége eines Mentis anzeigen lasst. 

. Beginnen Sie, folgende Zeile in den Code-Editor zu tippen: 

BearbeitenAl lesauswaehlen. Enable 

Hinweis: Wahrend Sie tippen, versucht REALbasic zu erraten, was Sie eintippen wollen. Wenn es einen Vorschlag hat, 
zeigt es diesen hellgrau an. Sobald Sie die Buchstaben ,,Bea“ eingegeben haben, vermutet es, dass Sie ,,Bearbeiten“ 
tippen wollen. 


. Driicken Sie die Tab-Taste, um den Vorschlag zu bestatigen. Der Code-Editor fiigt an der Einftigemarke ,,Bearbeiten‘ 
ein. Vervollstandigen Sie den Text zu BearbeitenAllesauswaehlen. 
. Tippen Sie einen Punkt, der als Trenner zwischen Objektnamen und seiner Eigenschaft verwendet wird. 


Der Code-Editor zeigt drei Punkte an. Wenn Sie darauf die Tab-Taste driicken, erhalten Sie ein Kontextmenti mit allen 
Eigenschaften, die zu Objekten des Typs Menultem gehoren, wie in folgender Abbildung zu sehen: 


e808 Code Editor (TextFenster) 

é Eigenschaften Sub EnableMenultems() 

v 9 a BearbeitenAllesAuswaehlen, BalloonHelp 
“S Activate End Sub Checked 
“5 CancelClose pda sisthcay 


“4 Close DisabledBalloonHelp 
“) Deactivate | 

“S DropObject 
EnableMenultems 


Wenn Sie den Buchstaben ,,e“ nach dem Punkt tippen, schlagt REALbasic ,,Enable“ vor und Sie konnen Tab driicken, 
um das zu tibernehmen. Alternativ konnen Sie sich mit den Cursortasten hoch/runter bis zu ,,Enable“ vorarbeiten. 
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Wenn der Code-Editor Objekt- oder Eigenschaften-Namen vorschlagt, konnen Sie diese durch Weitertippen verwer- 
fen. Sie tibernehmen einen bestimmten Vorschlag oder rufen das Kontextmenti mit der Tab-Taste auf. Der Code-Editor 
von TextFenster sollte nun so aussehen: 


Klicken Sie hier, eee Code Editor (TextFenster) 
um leere Event- — 
= Eigenschaften Sub EnableMenultems() 
Handler anzu- v9 events BearbeitenAllesAuswaehlen.Enable 
: “5 Activate End Sub 
Zeigen oder zu “5 CancelClose 
verstecken. “5 Close 


™) Deactivate 

“™) DropObject 

= EnableMenultems 
% KeyDown 


=] fet fo 


Der Event ,EnableMenultems* wird nun fett dargestellt, um anzuzeigen, dass er Code enthilt. Das zweite Icon unter 
dem Browser-Bereich erlaubt Ihnen, entweder alle Events anzuzeigen oder nur die, die Code enthalten. Normalerweise 
werden alle Events angezeigt, damit Sie, wenn Sie ein Programm schreiben, Code in die leeren Event-Handler hinein- 
schreiben kdnnen. Spiter werden Sie es begriiSen, leere Events zur besseren Ubersicht ausblenden zu kénnen. 


Speichern Sie Ihr Projekt unter dem Namen TextEditor-Kapitel3. 


Einem Menieintrag eine Funktion zuweisen 


Als letztes mtissen Sie REALbasic mitteilen, was passieren soll, wenn der Mentieintrag Alles auswahlen angewahlt wird. 
Dies nennt man einen Menu-Handler. Der Menii-Handler lduft automatisch ab, wenn der Anwender den Mentipunkt 
Alles auswahlen aufruft. 


In diesem Fall ftihrt der Menti-Handler die Textselektion durch. 

Folgendermafen programmieren Sie einen Menu-Handler fiir den Meniieintrag ,,Alles auswahlen*: 

1. Wahlen Sie, wenn der Code-Editor fiir TextFenster das oberste Fenster ist, den Mentipunkt Bearbeiten/Neuer 
Menu-Handler. 

2. Wahlen Sie BearbeitenAllesauswaehlen aus dem Popup-Menii und klicken Sie auf OK. 
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> G Eigenschaften — Menupunkt BearbeltenAllesAu... [= 
V @ Events 


lle 


Activate 


“3 CancelClose Crvtruch ) GOD 


Close 
= a au | 
‘| Deactivate 


“\ DropObject 
= EnableMenultems 
KeyDown ; 


6 F lel ie 
Eine neue Methode namens BearbeitenAllesauswaehlen erscheint in der Menu-Handlers-Kategorie des Code-Edi- 
tors von TextFenster. Der Code-Editor zeigt die Funktionsdeklaration. 
3. Tippen Sie folgendes ein: 


TextFeld.SelStart=0 
TextFeld.SelLength=Len(TextFeld. Text) 


Dieser Programmcode verwendet zwei Eigenschaften des EditField-Objekts — SelStart und SelLength— um zu 
bestimmen, welcher Text selektiert werden soll. SelStart legt die Position des ersten hervorzuhebenden Zeichens und 
SelLength die Lange der Selektion fest, beginnend bei SelStart. Die Length-Funktion ist eine globale Funktion, die die 
Lange der an sie tibergebenen Zeichenkette zuriickliefert. In unserem Fall wird der gesamte Text des TextFelds an die 
Length-Funktion tibergeben. 
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Diese Zeilen setzen den Beginn der Selektion auf den Beginn des Textes und die Lange der Selektion auf die Linge 
des Textes im TextFeld (die Text-Eigenschaft eines EditField enthalt den Text des EditFields). 
Der Code-Editor von TextFenster sollte nun so aussehen: 


e208 Code Editor (TextFenster) 


Vorwarts- und > Moved 
Riickwarts- Ao Function Action As Boolean 
UcKWarts: Co uly TextFeld.SelStart=0 
Navigationsknépfe F Paint TextFeld.SelLength=Len(TextFeld.Text) 
Resized End Function 
y &y Menu-Handler | 
> B® Methoden q 
> Ey Notizen 
> G® Steuerelemente 


Tey | 


Nachdem Sie den Code fiir einen zweiten Event-Handler eingegeben haben, ist der linke Pfeil unter dem Brow- 

ser-Bereich aktiviert. Die Pfeile sind Navigationsknépfe und funktionieren wie die Navigationskndpfe in einem 

Web-Browser. Sie k6nnen zum EnableMenultems-Event springen, indem Sie auf den Riickwarts-Pfeil klicken und wieder 

zurtick zum Menu-Handler, indem Sie dann auf den Vorwarts-Pfeil klicken. 

4. Speichern Sie Thr Projekt. Stellen Sie sicher, dass der Name TextEditor-Kapitel3 lautet. 

5. Starten Sie Ihr Programm. Falls dabei Probleme beim Compilieren auftreten, tiberpriifen Sie bitte, ob Sie das Edit- 
Field in TextFeld umbenannt haben. Falls Sie diesen Schritt versehentlich tibersprungen haben, kann REALbasic Refe- 
renzen auf Eigenschaften von TextFeld nicht aufldsen. 

6. Tippen Sie ein wenig Text in den Texteditor und testen Sie den Meniipunkt Alles aus- — "@ @ © _Namenios 
wahlen. Sie sollten sowohl iiber den Meniipunkt als auch iiber den Tastatur-Shortcut 
Kommando-A in der Lage sein, den gesamten Text zu selektieren, wie in folgender 
Abbildung gezeigt: 

7. Wenn Sie fertig sind, beenden Sie Ihr Programm und kehren zur Entwicklungsumge- 
bung zuriick. 


Ruckblick 


In diesem Kapitel haben Sie erfahren, wie man Meniti-Eintrdge hinzuftigt, diese aktiviert (enabled) und wie deren Ereig- 
nisse (Events) bearbeitet werden. 


4. Arbeiten mit Dokumenten 


In diesem Kapitel werden Sie mit Dokumenten arbeiten. Sie werden lernen, wie man: 


© Meniieintrage erzeugt, um Dokumente zu erzeugen, zu 6ffnen und zu speichern, 

© Programmcode schreibt, um diese Meniieintrige abzuarbeiten, 

@ eine ,Anderungen sichern‘-Dialogbox implementiert, die erscheint, wenn der Benutzer das Dokumentfenster 
schlie&t oder das Programm beenden will, obwohl es noch ungesicherte Anderungen gibt. 


Los geht's 


Suchen Sie die REALbasic-Projektdatei, die Sie am Ende des letzten Kapitels gespeichert haben (TextEditor-Kapitel3). 
Starten Sie REALbasic und 6ffnen Sie das Projekt. Falls n6tig, verwenden Sie die mitgelieferte Datei TextEdi- 
tor-Kapitel3, die Sie im Ordner Tutorial Projekt finden. 
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Arbeiten mit Textdokumenten 


Ein Texteditor muss in der Lage sein, Textdokumente zu laden und zu speichern. Als erstes werden Sie das Projekt um 
eine Funktion zum Anlegen neuer Dokumente erweitern. Wie Sie im vorigen Kapitel erfahren haben, sind drei Schritte 
erforderlich, um einen neuen Meniieintrag zu implementieren: 


© Hinzufiigen eines Meniieintrags in die Meniizeile, 
© Hinzuftigen eines Menu-Handlers. 


Erzeugen des Menieintrags Neu 
Um den Neu-Meniieintrag zu erzeugen, gehen Sie folgendermatsen vor: 


1. Fiihren Sie im Projekt-Fenster einen Doppelklick auf das Menii-Objekt aus und selektieren Sie den leeren Meniiein- 
trag im Menti Ablage (Windows: Datei). 


2. Im Eigenschaften-Fenster geben Sie fiir die Text-Eigenschaft Neu und ftir die CommandKey-Eigenschaft N ein. 
Tragen Sie als Name-Eigenschaft AblageNeu ein. 
3. Draggen Sie den Mentieintrag Neu an den Anfang des Meniis. 


Thr Menii-Editor und das Eigenschaften-Fenster des Mentieintrags Neu sollten jetzt folgendermafsen aussehen: 


is] Eigenschaften 


@ © @ = Anwendungs-Meni 
E é Ablage Bearbeiten 
Neu 


Name: AblageNeu 
Index: 


Super: Menultem v 


Text: Neu e 
Bold: 
tralic: F 
Underline: 

BalloonHelp: fe) 
DisabledBalloonH... e 
——————=—=—<—— as 
~ CommandKey: N 

SubMenu: © 


4. Schliefsen Sie den Menii-Editor. 


Verwalten des Menieintrags Neu 


Jetzt miissen Sie einen Menu-Handler schreiben, der ausgefiihrt wird, wenn der Benutzer den Meniieintrag aufruft. 
Ohne einen passenden Menu-Handler wiirde der Meniieintrag gar nichts bewirken. 

Der Menu-Handler fiir den Meniipunkt Neu erzeugt ein neues Objekt des Typs TextFenster. Dabei handelt es sich um 
eine Instanz der Objektklasse TextFenster mit all den in Kapitel 2 vereinbarten Eigenschaften. TextFenster ist ein Fenster, 
das bereits ein als Texteditor konfiguriertes TextFeld-Objekt enthalt. 

Um den Meniieintrag Neu zu verwalten, ist folgendes zu tun: 


1. Stellen Sie sicher, dass der Code-Editor von App ge6ffnet und das aktive Fenster ist. Ist dies nicht der Fall, mtissen Sie 
App im Projektfenster aktivieren und alt-Tab driicken. Rufen Sie den Mentipunkt Bearbeiten/Neuer Menu-Hand- 
ler auf, um einen Menu-Handler fiir den Meniipunkt Neu zu erzeugen. 


2. Wahlen Sie den Menu-Handler AblageNeu aus und klicken Sie auf OK. 


3. Geben Sie fiir den Menu-Handler folgenden Code in den Code-Editor ein: 
Dim w as TextFenster 
w=New TextFenster 


Die Dim-Anweisung erzeugt eine neue Variable des Typs TextFenster, nicht aber eine Instanz von TextFenster. Die 
Instanz wird erst in der nachsten Zeile durch den New-Operator kreiert und in w zurtickgeliefert. Die neue Instanz 
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w ist ein Klon von TextFenster und wird sofort angezeigt, da Sie im 2. Kapitel die Visible-Eigenschaft aktiviert hat- 
ten. 


4. Speichern Sie Ihr Projekt unter TextEditor-Kapitel4 und wechseln Sie dann zur Runtime-Umgebung, um den Menii- 
eintrag Neu zu testen. Sie werden feststellen, dass durch Aufrufen von Ablage/Neu (Windows: Datei/Neu) ein Klon 
des originalen TextFensters erzeugt wird. Das funktioniert auch dann, wenn gar kein TextFenster offen ist. 


Beenden Sie Ihr Programm, um in die Entwicklungsumgebung zurtickzukehren. 


Dateitypen 


Sie konnen festlegen, welche Dateitypen Ihr Programm erkennen soll. Wenn Sie zum Beispiel ein Grafikprogramm 
schreiben méchten, mtissen Sie REALbasic mitteilen, dass es Dateien der Typen PICT, TIFF, etc. laden kGnnen soll. Falls 
Thr Programm beim Speichern ein eigenes Dateiformat erzeugt, muss REALbasic dessen Dateityp ebenfalls kennen. 


Man verwendet die Dateitypen-Dialogbox, um die erlaubten Dateitypen zu definieren. Sie konnen die Dateity- 
pen-Dialogbox durch Anwahl von Bearbeiten/Dateitypen aufrufen. Die TextEditor-Applikation soll in der Lage sein, 
Textdateien zu offnen, zu modifizieren und zu speichern. Auf dem Macintosh verwendet das Programm den Dateityp 
,TEXT“, unter Windows den Dateityp ,,RTF* (Rich Text Format). Wahrend der Dateityp TEXT standardmafsig unterstiitzt 
wird, miissen Sie RTF noch hinzufiigen. 


Den Dateityp RTF hinzufiigen 


1. Wahlen Sie den Meniipunkt Bearbeiten/Dateitypen. Es erscheint die Dateitypen-Dialogbox. Der Dateityp TEXT ist 
bereits definiert. 


Dateitypen 


text 


(Hinzufiigen ) | earbeite Léschen 


Abbrechen _ ) or 


2. Klicken Sie auf den Knopf Neu..., um den Dateitypen-Editor aufzurufen. 

3. Nennen Sie den Dateityp rtf, geben Sie als Mac-Creator ????, als Mac-Typ TEXT und als Extension .rtf ein, wie in der 
folgenden Abbildung gezeigt. Creator und Typ sind case-sensitiv (es wird zwischen Grofs- und Kleinschreibung unter- 
schieden). 


Dateityp hinzufiigen 


Name: rtf @ 


Mac-Creator: 777? Mac-Typ: (TEXT _ 


Extension: | rtf 


(J Dokument-icon: | cons... 


(Aobrechen ) KD 


Der Creator-Code ???? sorgt daftir, dass unser TextEditor Text-Dateien 6ffnet, die von einem beliebigen Programm 
erzeugt wurden. Wenn Sie einen bestimmten Creator-Code angeben — wie z.B. ,,ttxt oder ,,.R*ch“ — wird der TextEdi- 
tor nur solche Textdateien 6ffnen kénnen. 


4. Klicken Sie auf OK, um den RTF-Dateityp abzuspeichern und im Dateitypen-Dialog auf OK, um diesen zu schliefen. 
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Speichern von Dokumenten 


Da Dokumente nur dann gespeichert werden k6nnen, wenn es ein offenes Dokumentfenster gibt, tibertragen Sie diese 
Aufgabe dem TextEditor-Fenster. Fiigen Sie dazu dem ,;TextFenster“ den Mentipunkt Sichern hinzu. Dabei ist Folgendes 
zu beachten: 


© Der Meniipunkt Sichern sollte nur dann aktiviert sein, wenn sich der Inhalt des aktuellen Fensters geandert hat — 
und nicht standig, wie dies fiir die Meniieintrage Neu und Alles auswahlen der Fall ist. 

@ Erzeugen eines Menu-Handlers: Der Menu-Handler ftir den Mentipunkt Sichern wird eine eigene Methode aufrufen, 
in der die Datei gespeichert wird. 

e Hinzufiigen der Methode zum Speichern der Datei: Diese Methode verwendet eine Objekt-Klasse namens Folder- 
Item, um den Inhalt des Fensters in einer Textdatei auf der Festplatte zu speichern. 


Hinzufiigen des Mentipunkts ,,Sichern” 
Um den Menitipunkt Sichern hinzuzufiigen, gehen Sie folgendermafen vor: 


1. Bringen Sie den Menii-Editor nach oben oder fiihren Sie, falls dieser noch nicht ge6ffnet ist, einen Doppelklick auf 
das Menti-Objekt im Projekt-Fenster aus. 

2. Selektieren Sie den leeren Mentieintrag im Menti Ablage (Windows: Datei) und verwenden Sie das Eigenschaf- 
ten-Fenster, um ihm den Text Sichern und den CommandKey $ zuzuweisen. 
Andern Sie — falls notwendig — die Name-Eigenschaft in AblageSichern. 

3. Deselektieren Sie unter Verhalten die AutoEnable-Eigenschaft. 
Wenn AutoEnable aktiv ist, ist der Mentipunkt immer anwahlbar. Dies haben Sie sich bereits beim Mentipunkt Neu zu 
Nutze gemacht. Fiir das Speichern-Menii ware dieses Verhalten nicht angebracht. Dieses soll weder aktiv sein, wenn 
gar kein Fenster geoffnet ist (trifft nur auf Mac OS zu), noch wenn es seit dem letzten Speichern keine Anderungen 
am Dokument gegeben hat. 


4, Draggen Sie den Mentipunkt Sichern zwischen den Neu- und den Beenden-Eintrag. 
Der Menii-Editor sollte nun folgendermafsen aussehen: 


(e) Eigenschaften 


@ © @ Anwendungs-Meni Name: AblageSichern 
= ~«é Ablage Bearbeiten Index: 


Sichern 3S 


Beenden#Q 


Super: Menultem v 


Text: Sichern e 
Bold: 
Italic: 
Underline: [ 
BalloonHelp: 
DisabledBallo... 


eo 


CommandkKey: S 
SubMenu: 1} 
AutoEnable: 2 


5. SchlieSen Sie den Menii-Editor. 


Hinzufiigen neuer Eigenschaften zu TextFenster 


Wenn Sie in einem Programm eine Datei laden, miissen Sie sich den Dateinamen merken, damit Sie Anderungen am 
Text spater speichern k6nnen. Zu diesem Zweck definieren Sie eine neue Eigenschaft ftir TextFenster, die den Dateina- 
men aufnimmt. Dies ist deswegen sinnvoll, da jedes weitere TextFenster, das gedffnet wird, einer bestimmten Datei zuge- 
ordnet ist. Augerdem werden Sie eine Eigenschaft hinzufiigen, die Anderungen am Text seit dem letzten Speichern 
mitverfolgt. 


Um eine neue Eigenschaft zu TextFenster hinzuzuftigen, gehen Sie folgendermafsen vor: 
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1. Selektieren Sie TextFenster im Projekt-Fenster und driicken Sie alt-Tab, um den Code-Editor zu 6ffnen. 


2. Wahlen Sie den Meniipunkt Bearbeiten/Neue Eigenschaft. 
Der Eigenschaften-Dialog erscheint. 


008 TextFenster Quellcode 
g Deklaration: | Dokument As Folderitem| 
G 
q Giltigkeitsbereich: _ Offentlich (Uberall) 
- (Im Eigenschaftenfenster anzeigen 
& 


Abbrechen) OD 


A +) |» oO 
3, Geben Sie Dokument As FolderItem ein, wahlen Sie als Giiltigkeitsbereich ,Offentlich (Uberall)* und klicken Sie 
dann auf OK (Folderltem ist der Name des REALbasic-Objekts, das auf Dateien und Ordner verweist). 
4, Wahlen Sie Bearbeiten/Neue Eigenschaft. Der Dialog zur Deklaration einer neuen Eigenschaft erscheint. 
5. Geben Sie TextWurdeGeandert As Boolean ein, wahlen Sie als Giiltigkeitsbereich ,,Offentlich (Uberall)* und klicken 
Sie dann auf OK. Der Datentyp Boolean kann genau zwei Werte annehmen: True (Wahr) oder False (Falsch). Im 


Abschnitt ,verwalten der TextWurdeGeandert-Eigenschaft* auf Seite 27 werden Sie diese Eigenschaft verwenden, um 
festzustellen, ob sich der Inhalt von TextFeld geandert hat. 


6. Klicken Sie auf das Dreieck links neben Eigenschaften im Code-Editor fiir TextFenster. 
Die Eigenschaften Dokument und TextWurdeGeandert werden aufgelistet. Der Eintrag Eigenschaften selbst ist 
fett geschrieben, um anzuzeigen, dass Eigenschaften hinzugeftigt wurden. 


Aktivieren der Meniieintrage 


Da der Meniipunkt Sichern nur anwahlbar sein soll, wenn es ungesicherte Anderungen im Dokument gibt, muss unser 
Quelltext die TextWurdeGeandert-Eigenschaft verwenden, die Sie gerade hinzugeftigt haben. 


Die TextWurdeGedndert-Eigenschaft dient als Markierung (Flag), an der REALbasic erkennen kann, ob der Anwender 
den Text im TextFenster verandert hat. 


Um den Meniieintrag zu aktivieren, gehen Sie folgendermafen vor: 


1. Falls der Code-Editor von TextFenster noch nicht ge6ffnet ist, wahlen Sie TextFenster im Projektfenster an und 6ffnen 
Sie den Code-Editor mit alt-Tab. 


2. Klicken Sie auf das Dreieck links neben dem Events-Eintrag, um die Events anzuzeigen. 


3. Selektieren Sie EnableMenultems und fiigen Sie folgende Zeilen am Ende der Methode an: 
If TextWurdeGedndert Then 
AblageSichern. Enable 


End if 

eee Code Editor (TextFenster) 

> @ Eigenschaften Sub EnableMenultems() 

v @ Events BearbeitenAllesAuswaehlen.Enable 

Activate If TextWurdeGeandert Then 

“S CancelClose AblageSichern.Enable 
“5 Close End if 
“5 Deactivate || End sub 


“\ DropObject 
= EnableMenultems 
KeyDown 2 


7 


Ele 
4. Speichern Sie Ihr Projekt. 
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Hinzufiigen einer DateiSichern-Methode 

Als nachstes miissen Sie die DateiSichern-Methode implementieren, die ausgeftihrt wird, wenn der Anwender den 
Sichern-Mentipunkt aufruft. Diese Methode wird durch die Menu-Handler der Meniipunkte Sichern und Sichern unter 
aufgerufen. Den ,,Sichern unter“-Meniieintrag werden Sie spater anlegen. 

Dies DateiSichern-Methode wird zwei Falle behandeln: 


© Der Benutzer wahlt Sichern, um ein existierendes Dokument zu sichern. 
© Der Benutzer wahlt Sichern oder Sichern unter, um ein ungesichertes oder ein bereits existierendes Dokument 
unter einem neuen Namen zu speichern. 


Im letzten Fall muss das Programm zunichst eine Dateiauswahlbox anzeigen, damit der Benutzer einen Dateinamen ein- 
geben kann. Im anderen Fall speichert das Programm das Dokument unter dem bestehenden Dateinamen. 


Die Methode DateiSichern ruft abhangig vom Wert der Boole’schen Variablen SichernDialogZeigen die Dateiauswahl- 
box zur Eingabe des Dateinamens auf. Deshalb kann DateiSichern verwendet werden, um sowohl den Meniipunkt 
Sichern, als auch den Meniipunkt Sichern unter zu verarbeiten. 

Um die DateiSichern-Methode hinzuzufiigen, mtissen Sie folgendermafsen vorgehen: 


1. Sorgen Sie daftir, dass der Code-Editor fiir das TextFenster das oberste Fenster ist und klicken Sie auf Bearbeiten/ 
Neue Methode. Die Dialogbox ftir eine neue Methode erscheint. 

2. Geben Sie der Methode den Namen DateiSichern. 
Im Parameter-Feld geben Sie folgendes ein: Dateiname as String,SichernDialogZeigen As Boolean 
Der ,,Neue Methode“-Dialog sollte jetzt folgendermafsen aussehen: 


088 TextFenster Quellcode 


Methode: _DateiSichern | 29 


Parameter: Dateiname As String, SichernDialogZeigen As 
Boolean 


: ; 
& Riickgabetyp ia) 
Giiltigkeitsbereich: | Offentlich (Uberall) 3) 
Ct] 
l “Abbrechen ) (550K) © 


3. Klicken Sie auf OK, um die Dialogbox zu schliefen. 
Der Code-Editor fiir die DateiSichern-Methode erscheint. Sie werden feststellen, dass der Methoden-Name und 
seine Parameter hinzugeftigt wurden. Wenn Sie den Namen oder einen Parameter andern méchten, kdnnen Sie dies 
nach einen Doppelklick auf die DateiSichern-Methode im Browser-Bereich des Code-Editors. 
Im nachsten Schritt geben Sie den Code ein, der die beiden beschriebenen Falle behandelt. 


4. Geben Sie folgenden Code fiir die DateiSichern-Methode in den Code-Editor ein: 
Dim f as FolderItem 
If Dokument=Nil or SichernDialogZeigen then 
f=GetSaveFolderItem("text",Dateiname) 
If f<>nil then //wenn der Anwender Sichern angeklickt hat 
Title=f.name 
Dokument=f 
End if 
End if 
If Not SichernDialogZeigen then //Anwender wahlte Sichern 
If Dokument<>nil Then 
Dokument. SaveStyledEditField TextFeld 
TextWurdeGedndert=False 
End If 
Elseif SichernDialogZeigen then //Anwender wadhlte SichernAls oder Neues Dokument 
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If Dokument <> Nil and f <> Nil then 
Dokument.SaveStyledEditField TextFeld 
TextWurdeGedndert=False 
End if 
End if 
Jede gedruckte Zeile muss in eine separate Zeile in den Code-Editor eingegeben werden. Lange Zeilen dtirfen nicht auf 


zwei Zeilen aufgeteilt werden. 


Falls die Dokument-Eigenschaft nicht definiert ist (ihr Wert also ,,Nil“ ist), wurde das Dokument noch nicht gesichert, so 
dass die ,,.Datei sichern unter“-Dialogbox angezeigt werden muss (daftir ist die GetSaveFolderltem-Funktion zustin- 
dig). 

Die Zeile Tit1e=f .name sorgt daftir, dass der Fenstertitel auf den Namen des Folderltem-Objekts — also des Dokuments 
— gesetzt wird. Title ist eine Eigenschaft der Fenster-Klasse, von der TextFenster abgeleitet wurde. Die Zeile Dokument=f 
weist der Dokument-Eigenschaft das aktuelle Dokument zu. 


Falls das Dokument bereits existiert, seine Dokument-Eigenschaft also nicht ,,Nil“ ist, muss die ,,Datei sichern unter“-Dia- 
logbox nicht gezeigt werden, da der Anwender das bereits existierende Dokument unter dem bestehenden Namen 
abspeichern will. In diesem Fall wird die SaveStyledEditField-Methode aufgerufen, um den Inhalt von TextFeld abzu- 
speichern. Dabei ist TextFeld der Wert des Parameters, der an die SaveStyledEditField-Methode der EditField-Klasse 
tibergeben wird. Aufserdem wird die Boole’sche TextWurdeGedndert-Eigenschaft wieder auf False gesetzt, da das 
Dokument seit dem letzten Sichern nicht mehr geandert wurde. 


Der Code-Editor sollte nun so aussehen: 


(Rok s) Code Editor (TextFenster) 


¥ (@ Eigenschaften 
{Gi Dokument as Foldert.. 


Sub DateiSichern(Dateiname as String, SichernDialogZeigen As Boolean) 
Dim f as Folderitem 


(Gy TextWurdeGeandert.. If Dokument=Nil or SichernDialogZeigen then 
> @ Events f=GetSaveFolderltem("text" ,Dateiname) 
> Menu-Handler If f<>nil then //wenn der Anwender Sichern angeklickt hat 
v B Methoden Title=f.name 
=) DateiSichern Dokument=f 
> EB Notizen End if 


End if 
If Not SichernDialogZeigen then //Anwender wahite Sichern 
If Dokument<>nil Then 


> @@ Steuerelemente 


Dokument.SaveStyledEditField TextFeld 
TextWurdeGeandert=False 
End If 
Elseif SichernDialogZeigen then //Anwender wahite SichernAls oder Neues Dokument 
If Dokument <> Nil and f <> Nil then 
Dokument.SaveStyledEditField TextFeld 
TextWurdeGeandert=False 
End if 
End iff 
End Sub 


BAe 

Bevor Sie die neue Methode verwenden kénnen, muss allerdings noch die Code-Zeile eingeftigt werden, die daftir sorgt, 
dass die TextWurdeGeandert-Eigenschaft auf True gesetzt wird, sobald der Anwender Anderungen am Text vornimmt. 
Darum werden Sie sich im Abschnitt ,Verwalten der TextWurdeGeindert-Eigenschaft* auf Seite 27 kiimmern. 


Verwenden der Online-Referenz 


Die eben implementierte DateiSichern-Methode verwendet zwei in REALbasic integrierte Methoden, um die eigentliche 
Arbeit zu verrichten: Sie ruft die globale Methode GetSaveFolderltem auf, um die ,,Datei sichern“-Dialogbox darzustel- 
len und macht von der SaveStyledEditField-Methode der Folderltem-Klasse Gebrauch, um den Inhalt des zum Text- 
Fenster gehGrenden EditFields abzuspeichern. Wenn Sie es wiinschen, kénnen Sie diese Methoden in der gedruckten 
REALbasic Sprachreferenz nachschlagen oder bequemer in der Online-Version dieser Referenz nachschauen. 


Um GetSaveFolderltem nachzuschlagen, gehen Sie folgendermafen vor: 


1. Rufen Sie den Mentipunkt Hilfe/Sprachreferenz auf. Damit Gffnen Sie den Dialog der Online-Referenz. Der Browser 
im linken Teil des Dialogs listet alle Haupteintrage auf, und zwar wahlweise thematisch oder alphabetisch geordnet. 
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Wonach sortiert werden soll, konnen Sie durch Klick auf Alpha oder Theme festlegen. Im Kopfbereich gibt es ein 
Suchfeld, das Sie zur Suche nach Sprachelementen oder anderen Ausdriicken verwenden konnen. 


eee Sprachreferenz 
«| »> fa) getsaveFolderitem Springer 
rrr GetSaveFolderitem Funktion 
UserCancetied.. Wird verwendet, um dem Anwender die Sichern-Unter-Dialogbox zu zeigen. 
Syntax 
¥ Dateien Ergebnis=GetSaveFolderltemifilter, default file name) 
AppleMenuFold.... Teil Art Beschreibung 
Application Klasse Ergebnis Folderitem Reprasentiert die Datei, die der Anwender anlegen mdchte. 
ApplicatonSupp... filter String Der Dateityp, der dieser Datei zugewiesen werden soll, so 
gaasvevacks wie er in der Dateitypen-Dialogbox definiert wurde. 
as default file name String Der in der Dialogbox vorgegebene Dateiname. 
ControlPanelsFo..J/ | | Hinweis 
Countfields(Qu... Die Funktion GetSaveFolderltem zeigt dem Benutzer die Standard-Sichern-Unter-Dialogbox, damit dieser einen Ort 
DesktopFolder-.. und einen Namen fur eine zu sichernde Datei festlegen kann. Wenn der Anwender Mac OS 8.5 oder neuer installiert hat, 


erscheint automatisch die neue ,Datei sichern"-Navigation-Services~Dialogbox. 


DocumentsFold... 

| Die Funktion GetSaveFolderitem legt diese Datei nicht an, sie liefert lediglich ein Folderitem, das die potentielle Datei 
ExportPicture (pi... reprasentiert. Um die Datei dann auch wirklich anzulegen, missen Sie die Methoden CreateBinaryFile oder 
ExtensionsFolde... CreateTextfile mit diesem Folderitem aufrufen. 
Folderitem Klasse Der filter sollte entweder ein leerer String sein oder der Name eines Dateityps, wie er in der Dateitypen-Dialogbox 
FolderttemDialo.... definiert wurde, so wie , image/gif’, .image/jpeg” oder .application/rtf". 
Bie x Unter Mac OS X erscheint eine Checkbox mit ,Suffix ausblenden” im ,Datei sichern"-Dialog. Die ExtensionVisible- 

olderitemP... Eigenschaft des zuruckgegebenen Folderitems wird auf die vom Anwender gewahlte Einstellung gesetzt. 
GetOpenFoldert.| | peispiele 
GetSaveFoldertt.. 
Dieses Beispiel zeigte die Sichern-Unter-Dialogbox. Danach wird eine Textdatei angelegt und die Text-Eigenschaften 
GetTemporaryF... ier EditFields werden in diese Datei geschrieben. SchlieSlich wird die Datei geschlossen. 
GetTrueFoldert... Dim file As Folderitem 
OpenDialog Kia... Dim fileStream as TextOutputStream 4 
PreferencesFold... a file=GetSaveFolderItem("" ,"Mein Info") 3 
y | (if fileoNil then 


SavpAsDialon Kl booeea ne err 


2. Geben Sie GetSaveFolderltem im Suchfeld ein und klicken Sie auf Suchen. Wie immer versucht REALbasic, beim Tip- 
pen das Wort zu erkennen, das Sie eingeben. Driicken Sie zu einem beliebigen Zeitpunkt Tab, um ein Kontextmenii 
aufzurufen oder den Vorschlag zu tibernehmen. 


3. Im Hauptbereich des Referenz-Fensters erscheint die Dokumentation zu GetSaveFolderltem. Dabei werden Hyper- 
text-Verweise auf verwandte Themen blau und unterstrichen dargestellt. Sie k6nnen nun auf einen der Folderl- 
tem-Verweise klicken und dort in der Methodentabelle die SaveStyledEditField-Methode nachlesen. Die Pfeile im 
Kopfbereich sind Vorwarts- und Riickwarts-Knopfe und funktionieren wie in einem Web-Browser. 

Code-Beispiele werden in gepunkteten Rahmen angezeigt und konnen per Drag & Drop in den Code-Editor tiber- 
nommen werden. 


4. Um die Online-Referenz wieder zu schliefen, klicken Sie einfach auf den SchlieSknopf des Fensters. 


Verwalten der TextWurdeGeandert-Eigenschaft 


Der TextWurdeGedndert-Eigenschaft muss immer dann der Wert True (,wahr“) zugewiesen werden, wenn sich am Inhalt 
von TextFeld etwas andert. Dies wird im TextChange-Event-Handler von TextFeld erledigt. 


Ein Event-Handler ist eine Methode, die automatisch ablauft, wenn ein bestimmtes Ereignis eintritt. Jedes Inter- 
face-Objekt in REALbasic besitzt einen Satz leerer Event-Handler fiir Events, die REALbasic automatisch erkennen kann. 
Programmcode, den Sie in einen dieser Event-Handler eingeben, wird also ausgefiihrt, wenn das jeweilige Event eintritt. 
Dieses Konzept nennt man event-gesteuerte Programmierung. 
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Welche Events bei einem EditField verfiigbar sind, erfahren Sie, wenn Sie den Code-Editor von TextFenster nach oben 
bringen und im Browser den Eintrag Steuerelemente und dann das TextFeld-Objekt expandieren. Dann sehen Sie eine 
Liste der Event-Handler eines EditFields: 


eco°e8 Code Editor (TextFenster) 
> Bi Notizen Sub TextChange() 

V G Steuerelemente 

Vv WoTextFeld End Sub 


™ Close 

“S DropObject 

“ GotFocus 

“™\ KeyDown 

™ LostFocus 

“| MouseDown | 
“\ MouseEnter 
™) MouseExit 
“\ MouseMove 
™ MouseUp 
“ Open 

“S SelChange 
“ TextChange 7 


He» 


Um die TextWurdeGedndert-Eigenschaft zu verwalten, gehen Sie folgendermafsen vor: 


1. 
2. 


Selektieren Sie den TextChange-Event. 

Fiigen Sie folgende Code-Zeile in den leeren Event-Handler ein: 

TextWurdeGedndert=True 

Da Sie diese Code-Zeile im TextChange-Event-Handler abgelegt haben, wird sie immer dann automatisch ausgefiihrt, 
wenn Anderungen am Text im TextFeld vorgenommen werden. REALbasic iibernimmt den Job herauszufinden, ob es 
Anderungen gibt. 


In der Online-Referenz werden die ftir jedes Steuerelement verfiigbaren Event-Handler beschrieben. 


Behandeln des Menieintrags 


Der Menu-Handler fiir den Meniipunkt Sichern ruft die DateiSichern-Methode auf, die Sie gerade implementiert haben 
und tibergibt den Wert False an SichernDialogZeigen, um zu verhindern, dass die Dateiauswahlbox angezeigt wird 
(aufer, es handelt sich um ein bisher ungesichertes Dokument). 


1. 


2. 


Wahlen Sie den Meniipunkt Bearbeiten/Neuer Menu-Handler. Wahlen Sie AblageSichern aus dem Popup-Menii 
aus und klicken Sie auf OK. 

Ein neuer Menu-Handler namens AblageSichern erscheint im Browser-Bereich des Code-Editors. 

Geben Sie folgenden Code ein: 

DateiSichern Title, False 

Dieser Menu-Handler ruft die Methode DateiSichern auf, die die eigentliche Arbeit erledigt. Die dem Methodenna- 
men folgenden Begriffe — Title und False — sind die Parameter, die an die DateiSichern-Methode tibergeben werden. 
Machen Sie sich noch einmal klar, dass DateiSichern zwei Parameter erwartet. Beim ersten (einer Zeichenkette) han- 
delt es sich um den Namensvorschlag fiir die zu sichernde Datei. Der zweite Parameter ist vom Typ Boolean und legt 
fest, ob eine ,Anderungen sichern“-Dialogbox angezeigt werden soll (die Sie noch programmieren miissen) oder 
nicht. Bei dem Ausdruck ,,Title“ handelt es sich um die Title-Eigenschaft der Window-Klasse, die die Zeichenkette 
enthalt, die im Titelbalken als Fenstertitel angezeigt wird. 


Wenn Sie ein Dokument zum ersten Mal speichern, wird ,Namenlos“ als Namensvorschlag verwendet, da dies der 
Standard-Fenstertitel ist. 


Sichern Sie Ihr Projekt. 


. Wahlen Sie Debug/Programm starten, um Ihre Applikation zu testen. Beachten Sie, dass der Mentipunkt Sichern 


solange inaktiv (disabled) bleibt, bis Sie den Text im Texteditor andern. 
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5. Beenden Sie Ihr Programm, um zur Entwicklungsumgebung zurtickzukehren. 


Hinzufiigen eines Meniipunkts Sichern unter 

Der Menitipunkt Sichern unter erfiillt die gleiche Funktion wie der Meniieintrag Sichern, mit dem Unterschied, dass er 

immer die Dateiauswahlbox anzeigt, die es dem Anwender erméglicht, das Dokument unter einem neuen Namen abzu- 

speichern. Er wird auf die gleiche Weise wie der Sichern-Mentipunkt angelegt. 

Gehen Sie dazu folgendermafen vor: 

1, Fiihren Sie einen Doppelklick auf den Menu-Eintrag im Projekt-Fenster aus und fiigen Sie dem Ablage-Menii (Win- 
dows: Datei-Menii) einen neuen Mentipunkt mit dem Text Sichern unter... hinzu. Andern Sie die Name-Eigen- 
schaft — falls erforderlich — auf AblageSichernunter. 

2. Draggen Sie den neuen Mentipunkt zwischen die Eintrage Sichern und Beenden. 


3, Offnen Sie den EnableMenultems-Event im Code-Editor von TextFenster und hiingen Sie folgende Zeile ans Ende 
der Methode an: 
AblageSichernunter. Enable 

4. Rufen Sie bei aktivem Code-Editor von TextFenster den Meniipunkt Bearbeiten/Neuer Menu-Handler auf und 
wahlen Sie dort AblageSichernunter aus. 

5. Geben Sie folgende Code-Zeile ein: 

DateiSichern Title, True 
Dieser Menu-Handler erledigt das Sichern ebenfalls mit Hilfe der DateiSichern-Methode, erzwingt jedoch die Anzeige 
der Dateiauswahlbox. 

6. Speichern Sie Thr Projekt und testen Sie die Sichern- und Sichern unter- Befehle durch Anwahlen von Debug/Pro- 
gramm starten. Geben Sie ein wenig Text ein und speichern Sie ihn mit dem Sichern-Befehl. Verwenden Sie dann 
den Sichern unter-Befehl. Beachten Sie, dass der Sichern unter-Befehl den Titel des TextFensters als Namensvor- 
schlag anbietet. 


7. Beenden Sie Ihr Programm, um zur Entwicklungsumgebung zuriickzukehren. 


Hinzufiigen des Offnen-Meniieintrags 


Nachdem Sie nun die Routinen fiir ,Sichern“ und ,,Sichern unter“ implementiert haben, benGtigt der Anwender noch 
eine Moglichkeit, die Dokumente, die er gespeichert hat, wieder zu laden. Die folgende Ubung implementiert einen 
Offnen-Meniieintrag. Sie werden: 

e einen Offnen-Meniieintrag anlegen, 

© den Meniieintrag aktivieren, 

© einen Menu-Handler fiir den Eintrag schreiben. 


Erzeugen des Offnen-Meniieintrags 
Um den Offnen-Meniieintrag zu erzeugen, gehen Sie folgendermafen vor: 


1. Fiihren Sie einen Doppelklick auf dem Menu-Eintrag im Projekt-Fenster aus und selektieren Sie den leeren Eintrag 
im Ablage-Menti (Windows: Datei-Menii). Falls der Menti-Editor sich nicht 6ffnen lasst, schauen Sie nach, ob der 
Mentipunkt Debug/Kill aktiv ist. Wenn ja, Jduft das Programm noch in der Runtime-Umgebung und muss erst been- 
det oder mit Debug/Kill abgebrochen werden. 


2. Geben Sie im Eigenschaften-Fenster fiir den neuen Meniipunkt als Text-Eigenschaft Offnen... ein und O als 
CommandkKey-Eigenschaft. Die Name-Eigenschaft andern Sie in AblageOeffnen (mit Oc“ statt ,0*). 


3. Draggen Sie den Offnen-Meniipunkt zwischen den Neu- und den Sichern-Meniieintrag. 
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Verarbeiten des Menteintrags 


Da das Offnen-Menii auch dann funktionieren muss, wenn keine Fenster offen sind, gehért sein Menii-Handler in das 
Application-Objekt. 
Um den Offnen-Meniieintrag zu verwalten, ist folgendes zu tun: 


1. Rufen Sie bei aktivem Code-Editor der App-Klasse Bearbeiten/Neuer Menu-Handler auf, um einen Menu-Handler 
fiir den Offnen-Meniipunkt zu erzeugen. 


2. Selektieren Sie im Popup den Ablageoeffnen-Menu-Handler, klicken Sie OK und geben Sie folgenden Code in den 
Code-Editor ein: 
Dim f as FolderItem 
Dim w as TextFenster 
f=GetOpenFolderItem("text") //Datei Offnen-Dialog anzeigen 
If f<>nil then //Der Anwender hat auf Offnen geklickt 
w=New TextFenster //Neue Instanz von TextFenster erzeugen 
f .OpenStyledEditField w.TextFeld 
w.Dokument=f //weise f der Dokument-Eigenschaft von TextFenster zu 
w.Title=f.name //weise Namen von f dem Titel von TextFenster zu 
End if 


Die ersten zwei Zeilen erzeugen ein neues Folderltem-Objekt (eine Referenz auf ein Dokument) und eine neue In- 
stanz der TextFenster-Klasse zur Anzeige des Dokuments. An dieser Stelle hat f noch keinen Wert, sondern ist lediglich 
ein Container, der in der Lage ist, auf ein Dokument zu verweisen. Genauso verweist w nicht auf eine neue Instanz 
von TextFenster, solange diese nicht mit der Funktion New erzeugt wurde. 

Als nachstes wird die globale Methode GetOpenFolderltem aufgerufen, die den ,,Datei 6ffnen“-Dialog anzeigt und eine 
Referenz auf das vom Anwender ausgewahlte Dokument zuriickliefert. Der Parameter ,,text“ teilt der GetOpenFolder- 
Item-Methode mit, dass nur Textdateien in der Dateiliste erscheinen sollen. Den Dateityp ,,text“ haben Sie dem Projekt 
ja bereits hinzugefiigt. 

Wenn der Anwender erfolgreich ein Text-Dokument 6ffnet, liefert die GetOpenFolderltem-Funktion eine Referenz auf 
das Dokument im Folderltem-Objekt f. 

Der Code testet zuerst, ob f immer noch den Wert Nil hat — das ware der Fall, wenn der Anwender den ,,Datei 6ff- 
nen*-Dialog mit dem Abbrechen-Knopf verlassen hat. Ist f ungleich Nil, wird ein neues Dokumentfenster gedffnet und 
die OpenStyledEditField-Methode der Folderltem-Klasse aufgerufen. Diese Methode platziert den Text, der nun f ist, 
in das TextFeld, das zu der neu erzeugten Instanz von TextFenster gehort. 

SchlieSlich wird der Dokument-Eigenschaft des TextFensters das Folderltem (also das vom Anwender ge6ffnete Do- 
kument) zugewiesen und als Fenstertitel der Name des Dokuments eingesetzt. 

Informationen zu Folderltem, GetFolderltem und Window-Klasse finden Sie in der Online-Referenz. 


3. Speichern Sie Thr Projekt. 


4, Wechseln Sie in die Runtime-Umgebung und testen Sie die Offnen- und Sichern-Kommandos. 
Wenn Sie Fehlermeldungen erhalten wie ,Unbekannter Bezeichner“ oder andere Probleme auftreten, tiberpriifen 
Sie, ob Sie alle Objekte umbenannt haben und den Code jeweils in den richtigen Code-Editor eingegeben haben. 
Wenn Sie trotzdem weiterhin Probleme haben, laden Sie das ,TextEditor-Kapitel4-Projekt von der CD und verglei- 
chen es mit Ihrem Projekt. 


5. Beenden Sie die Applikation und kehren Sie zur Entwicklungsumgebung zuriick. 


Ruckblick 


In diesem Kapitel haben Sie Ihr Programm um die Fahigkeiten Dokumente zu laden, zu erzeugen, zu schliefSen und zu 
speichern erweitert. 
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5. Hinzufiigen einer ,,Anderungen sichern” -Dialogbox 


Fin benutzerfreundliches Programm gibt dem Anwender die Gelegenheit, Anderungen in offenen Dokumenten zu 
sichern, wenn er ein Fenster schliefst oder das Programm beenden will. Unser Programm macht da keine Ausnahme. In 
dieser Ubung werden Sie die unten abgebildete Anderungen sichern-Dialogbox erzeugen. 


Anderungen vor dem SchlieBen des Dokuments 
sichern? 
‘ A Wenn Sie nicht sichern, gehen die Anderungen verloren. 


(Nicht sichern ) ( Abbrechen ) (Sichern ) 


Erzeugen der Dialogbox 


Zum Erzeugen der Dialogbox werden wir eine in REALbasic integrierte Klasse — die MessageDialog-Klasse verwenden. 
Diese dient zum Anzeigen kurzer Mitteilungen und bietet dem Anwender auch eine Interaktionsméglichkeit. Wenn Sie 
MessageDialog zum Anzeigen einer Dialogbox verwenden, miissen Sie daftir nicht extra ein Fenster erzeugen und zu 
Threr Projektdatei hinzuftigen. 

Die MessageDialog-Klasse verwendet nicht den Fenster-Editor. Statt dessen erzeugen Sie in Ihrem Code eine Instanz der 
MessageDialog-Klasse und verwenden ihre Eigenschaften, um das Aussehen des Dialogs zu bestimmen. 


Ein MessageDialog-Fenster kann folgende Elemente enthalten: 


Eigenschaft Beschreibung 
Icon Symbol, das links neben der Nachricht angezeigt wird. 
Message Nachricht, die im Dialog angezeigt wird. 
Explanation Zusatzliche Erklarung, die kleiner als die eigentliche Nachricht angezeigt wird. 
ActionButton Lost die Standardaktion aus. 
CancelButton Bricht die Aktion ab. 
AlternateActionButton —_| Lést eine alternative Aktion aus. 
Title Uberschrift fiir die Titelzeile des Dialogs. Wird auf dem Mac nicht angezeigt. 
Die MessageDialog-Klasse sorgt automatisch fiir die richtige Groe des Dialogs und die Platzierung der Elemente. 


Hinweis: Die Windows-Version der MessageDialog-Klasse ordnet die Knépfe in einer anderen Reihenfolge als die Macin- 
tosh-Version an und unterstiitzt zusatzlich die Title-Eigenschaft. 

Jeder Knopf eines MessageDialogs ist ein MessageDialogButton-Objekt. Ein MessageDialogButton hat spezielle Eigen- 
schaften, die in der folgenden Tabelle aufgeftihrt sind. 


Eigenschaft Beschreibung 


Caption Die Beschriftung des Knopfes. 

Visible Auf True setzen, um den Knopf anzuzeigen. 

Default Auf True setzen, um den Knopf als Standardknopf zu hervorzuheben. Standardmiaitig ist diese Eigenschaft 
fiir die Klasse ActionButton auf True gesetzt. 

Cancel Auf True setzen, damit dieser Knopf auf das Driicken der Esc-Taste reagiert. Unter Mac OS reagiert dieser 


ebenso auf das Driicken von $-.,.“. Diese Eigenschaft kann nur ftir einen Knopf auf True gesetzt sein. Einige 
Betriebssysteme erlauben nicht, dass der Cancel-Knopf gleichzeitig Standardknopf ist. 
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Sie miissen nun eine Methode schreiben, die eine Instanz der MessageDialog-Klasse erzeugt, ihren Eigenschaften die 
korrekten Werte zuweist und abhangig vom angeklickten Knopf die passenden Aktionen ausfiihrt. 


Eigenschaften des MessageDialogs festlegen 


Standardmafsig wird nur der ActionButton eines MessageDialogs angezeigt. Um die beiden anderen Knépfe anzuzeigen, 
muss deren Visible-Eigenschaft auf True gesetzt werden. Aufserdem muss das Symbol festgelegt werden. Der folgende 
Code legt das Aussehen der ,Anderungen sichern*-Dialogbox fest: 


Dim d as New MessageDialog //MessageDialog-Objekt deklarieren 

Dim b as New MessageDialogButton //Zum Verarbeiten des Ergebnisses 
d.icon=1 //Warnsymbol zeigen 
-ActionButton.Caption="Sichern" 
.CancelButton.Visible=True //Abbrechen-Knopf zeigen 
.CancelButton.Caption="Abbrechen" 
.AlternateActionButton.Visible=True //Nicht Sichern-Knopf zeigen 
-AlternateActionButton.Caption="Nicht sichern" 

.Message="Anderungen vor dem SchlieBen des Dokuments sichern?" 
d.Explanation="Wenn Sie nicht sichern, gehen die Anderungen verloren." 


Interessant an diesem Programmcode ist die Zeile d.ActionButton.Caption="Sichern". Dabei wurde die 
Punkt-Notation, die Sie bereits verwendet haben, um eine Eigenschaft eines Objekts anzusprechen, dahingehend erwei- 
tert, dass nun eine Eigenschaft eines Objekts, das zu einem anderen Objekt gehort, angesprochen wird. 


[eR os og eS 


Benutzereingaben verarbeiten 


Nachdem Sie den MessageDialog ,,konstruiert* haben, miissen Sie ihn dem Anwender prasentieren und auf dessen 
Knopfdruck entsprechend reagieren. Darum ktimmert sich der folgende Code-Schnipsel. Die Variable b wird dabei als 
MessageDialogButton deklariert und enthalt den Knopf, den der Anwender angeklickt hat. 
b=d.ShowModal //Dialog anzeigen und auf Benutzereingaben warten 
Select Case b //Feststellen, welcher Knopf angeklickt wurde 
Case d.ActionButton //Anwender hat Sichern angeklickt 
DateiSichern Title,False 
Close 
Case d.AlternateActionButton 
//Anwender hat Nicht sichern angeklickt 
//Fenster kann ohne Sichern der Anderungen geschlossen werden 
Case d.CancelButton //Anwender hat Abbrechen angeklickt 
Return True //SchlieBen des Fensters abbrechen 
End select 


Die ShowModal-Methode der MessageDialog-Klasse liefert einen MessageDialogButton zurtick (den Sie im ersten Teil 
des Quelltextes deklariert hatten. Bei diesem MessageDialogButton handelt es sich um den Knopf, den der Anwender 
angeklickt hat. 

Um welchen der drei Kndpfe es sich dabei handelt, ermittelt die Select-Case-Anweisung, die die drei Méglichkeiten tes- 
tet. Jede Select-Anweisung der Select-Case-End-Struktur testet das MessageDialogButton-Objekt b auf einen konkreten 
Wert. Ist b der ActionButton, wird die DateiSichern-Methode ausgeftihrt und der Inhalt des aktuellen Dokuments gespei- 
chert. Ist b der AlternateActionButton, passiert gar nichts. Ist b der CancelButton, wird das Schlie&en des Fensters bzw. 
das Beenden der Applikation abgebrochen und der CancelClose-Event-Handler liefert True zurtick. 


Integration der ,,Anderungen sichern”-Dialogbox in Ihr Projekt 


Der letzte Schritt besteht darin, den ,Anderungen sichern‘-Dialog anzuzeigen, wenn der Anwender den Beenden-Menii- 
punkt aufruft oder ein Dokumentfenster schliefst. Dies wird im CancelClose-Event-Handler von TextFenster realisiert. 


Der Meniipunkt Ablage/Beenden (Windows: Datei/Beenden) unterscheidet sich von den Mentipunkten, die Sie 
selbst angelegt haben. So ist Beenden eine Instanz der QuitMenultem-Klasse und nicht der Menultem-Klasse. Sie 
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konnen dies tiberpriifen, indem Sie den Meniipunkt Beenden im Menii-Editor selektieren und sich seine Eigenschaften 
anschauen. 


AuSerdem ist das Beenden-Menii per Vorgabe aktiviert. Sie haben es schon mehrfach benutzt, um nach einem Testlauf 
unseres Beispielprojekts in die Entwicklungsumgebung zuriickzukehren, ohne dass Sie es vorher aktivieren mussten. 


Schlieflich hat das Beenden-Menii auch seinen eigenen Menii-Handler, der die in REALbasic integrierte Quit-Methode 
aufruft. Diese versucht, das Programm zu beenden. Dazu ruft sie fiir jedes offene Fenster den CancelC- 
lose-Event-Handler auf. Dieser Event-Handler ermoglicht Ihnen, das Beenden der Applikation zu unterbrechen, um vor- 
her noch bestimmte Aktionen auszufiihren (z.B. ungesicherte Anderungen an Dokumenten abzuspeichern). 


Falls der CancelClose-Event False zuriickliefert (das ist normalerweise der Fall und besagt, dass das Beenden des Pro- 
gramms nicht abgebrochen werden soll), wird der Close-Event-Handler des Fensters ausgeftihrt. Wenn der Cancel- 
Close-Event True zuriickgibt, schickt REALbasic keine weiteren CancelClose- oder Close-Events und das Programm 
wird nicht beendet. 


Die CancelClose-Methode, die Sie jetzt implementieren werden, 6ffnet die Anderungen sichern-Dialogbox, falls die 
TextWurdeGedandert-Eigenschaft den Wert True hat. Sie ermittelt dann, welchen Knopf der Benutzer in der Anderun- 
gen sichern-Dialogbox gedriickt hat. Nur wenn der Benutzer auf den Sichern-Knopf geklickt hat, wird die Datei- 
Sichern-Methode aufgerufen. 


Um den CancelClose-Code hinzuzuftigen, ist folgendes zu tun: 


1. Expandieren Sie im Code-Editor von TextFenster den Events-Eintrag und selektieren Sie den CancelClose-Eintrag. 
Achtung: Sie befinden sich nun wieder im Code-Editor fiir TextFenster. 


2. Geben Sie folgenden Code ein: 
Dim d as New MessageDialog //MessageDialog-Objekt deklarieren 
Dim b as New MessageDialogButton //Zum Verarbeiten des Ergebnisses 
If TextHasChanged then 
.icon=1 //Warnsymbol zeigen 
-ActionButton.Caption="Sichern" 
.CancelButton.Visible=True //Abbrechen-Knopf zeigen 
.CancelButton.Caption="Abbrechen" 
.AlternateActionButton.Visible=True //Nicht Sichern-Knopf zeigen 
.AlternateActionButton.Caption="Nicht sichern" 
.Message="Anderungen vor dem SchlieBen des Dokuments sichern?" 
.Explanation="Wenn Sie nicht sichern, gehen die Anderungen verloren." 
b=d.ShowModal //Dialog anzeigen und auf Benutzereingaben warten 
Select Case b //Feststellen, welcher Knopf angeklickt wurde 
Case d.ActionButton //Anwender hat Sichern angeklickt 
DateiSichern Title,False 
Close 
Case d.AlternateActionButton 
//Anwender hat Nicht sichern angeklickt 
//Fenster kann ohne Sichern der Anderungen geschlossen werden 
Case d.CancelButton //Anwender hat Abbrechen angeklickt 
Return True //SchlieBen des Fensters abbrechen 
End select 
End if 
Dieser Code testet, ob der Text verandert wurde, indem er den Wert der TextWurdeGeandert-Eigenschaft abfragt. Ist 


dieser True, wird die Anderungen sichern-Dialogbox angezeigt. 

Die Anweisung d.ShowModal fiihrt die ShowModal-Methode der MessageDialog-Klasse aus und liefert den Message- 
DialogButton zurtick, den der Anwender angeklickt hat. 

Die Select-Case-Struktur stellt fest, welchen Knopf der Anwender gedriickt hat. Falls er Nicht sichern angeklickt hat, 
wird das Beenden des Programms fortgesetzt, da CancelClose in diesem Fall False zurtickliefert und keine Methode 
zum Speichern des Dokuments aufgerufen wird. Wenn der Anwender Abbrechen anklickt, liefert CancelClose den 
Wert True zuriick und das Programm wird nicht beendet. Klickt der Anwender auf Sichern, so wird die 
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DateiSichern-Methode ausgeftihrt. Diese erhalt als Parameter den Namen des Fensters (die Title-Eigenschaft der Win- 
dow-Klasse enthalt den Namen des jeweiligen Fensters) und False (dies teilt der DateiSichern-Methode mit, dass sie 
nicht die Dateiauswahlbox anzeigen soll). 


3. Speichern Sie Ihr Projekt unter TextEditor-Kapitel5. Der Code-Editor ftir die CancelClose-Methode sollte nun so 
aussehen: 


eee TextFenster Quellcode 
¥ @ Eigenschaften 


(di Doku ‘As Fol Function CancelClose(appQuitting as Boolean) As Boolean 


Dim d as New MessageDialog //MessageDialog-Objekt deklarieren 


GE) TextWurdeGedindert Dim b as New MessageDialogButton //Zum Verarbeiten des Ergebnisses 
¥: P Events If TextWurdeGeandert then 
Activate d.icon=1 //Warnsymbol zeigen 


CancelClose d.ActionButton.Caption="Sichern" 

Close d.CancelButton.Visible=True //Abbrechen-Knopf zeigen 

™ Deactivate d.CancelButton.Caption="Abbrechen" 

“5 DropObject d.AlternateActionButton.Visible=True //Nicht Sichern-Knopf zeigen 
d.AlternateActionButton.Caption="Nicht sichern” 
d.Message="Anderungen vor dem Schlie&en des Dokuments sichern?" 
d.Explanation="Wenn Sie nicht sichern, gehen die Anderungen verioren." 
b=d.ShowModal //Dialog anzeigen und auf Benutzereingaben warten 


=) EnableMenultems 


KeyDown 
™\ Maximize 


“\ Minimize Select Case b //Feststellen, welcher Knopf angeklickt wurde 
™\ MouseDown Case d.ActionButton //Anwender hat Sichern angeklickt 

“™S MouseDrag DateiSichern Title,False 

“5 MouseEnter Close 


Case d.AlternateActionButton 
//Anwender hat Nicht sichern angeklickt 
//Fenster kann ohne Sichern der Anderungen geschlossen werden 


“™ MouseExit 
™) MouseMove 


_ MouseUp Case d.CancelButton //Anwender hat Abbrechen angeklickt 
Ba Moved Return True //SchlieBen des Fensters abbrechen 
| Open End select 
“) Paint a End if 
“ Resized ’ End Function 
EF] |¢| |» 


4, Testen Sie die ,Anderungen sichern‘-Dialogbox, indem Sie in die Runtime-Umgebung wechseln, ein neues Doku- 
ment erzeugen, es speichern und es dann modifizieren. Wenn Sie danach Ihr Programm beenden, sollte die ,Ande- 
rungen sichern‘-Dialogbox erscheinen. Wenn Sie auf Nicht sichern“ klicken, sollte sich Ihr Programm beenden. 
Wenn Sie auf ,,Sichern“ klicken, erscheint eine Dateiauswahlbox. Wenn Sie auf ,,Abbrechen“ klicken, wird der Vorgang 
abgebrochen und das Programm nicht beendet. 


Ruckblick 


In diesem Kapitel haben Sie gelernt, wie eine MessageDialog-Box funktioniert. 


6. Drag und Drop einbauen 


In diesem Kapitel erweitern Sie das Programm um die Fahigkeit, Text-Dokumente einfach durch Draggen vom Desktop 
auf ein offenes Fenster zu 6ffnen. Sie k6nnen mehrere Dokumente auf einmal draggen. Dabei kann das Zielfenster ent- 
weder leer sein oder schon ein Dokument enthalten. 


Sie werden lernen, wie man 


© ein EditField-Steuerelement so konfiguriert, dass es gedraggte Dateien akzeptiert, 
e mehrere gedraggte Dateien abarbeitet. 


EditFields unterstiitzen automatisch Drag & Drop innerhalb von REALbasic, wenn die MultiLine-Eigenschaft gesetzt ist. 
Die Schritte in diesem Kapitel sind nétig, um externe Dokumente per Drag & Drop zu verarbeiten. 


Los geht's 
Wenn Thr Projekt nicht bereits geoffnet ist, laden Sie die Datei ,TextEditor-Kapitel5* von Ihrer REALbasic-CD. 


TextFeld fiir Drag & Drop von Dokumenten vorbereiten 


Der erste Schritt besteht darin, TextFeld so zu konfigurieren, dass es gedraggte Textdateien akzeptiert. 
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Bevor ein Steuerelement gedragete Objekte akzeptiert, mtissen Sie festlegen, welche Dateitypen es akzeptieren soll. 
Dies geschieht im Dateitypen-Dialog. 


Da TextFeld immer gedraggte Dateien akzeptieren soll, sorgen Sie im Open-Event-Handler von TextFeld daftir. Dieses 
Event lauft als erstes ab, wenn ein Dokument-Fenster geGffnet wird. 


Um den Textdateien-Typ hinzuzuftigen, ist folgendes zu tun: 
1. Expandieren Sie im Code-Editor von TextFenster unter Steuerelemente das TextFeld-Objekt und 6ffnen Sie den 
Open-Event-Handler. 


2. Figen Sie dieser Methode folgenden Code hinzu: 


// erlaubt Drag & Drop von Textdateien 
Me.AcceptFileDrop("text") 
Mit der Methode AcceptFileDrop legen Sie fest, welche Dateitypen auf ein Steuerelement gedraggt werden diirfen. 


Der Parameter ,,text ist der Name des Dateityps, den Sie in Kapitel 4 definiert haben. 


Schlieflich miissen Sie festlegen, wie sich TextFeld verhalten soll, wenn der Anwender eine oder mehrere Dateien die- 
ses Typs gedraget hat. Dazu bietet sich der DropObject-Event-Handler an. 


Um gedraggte Dateien abzuarbeiten, ist folgendes zu tun: 


1. Selektieren Sie den DropObject-Event-Handler von TextFeld 
Dieser bekommt den Parameter ,obj As Dragltem* iibergeben. Uber die Eigenschaften der Dragltem-Klasse kén- 
nen Sie feststellen, welche Datentypen auf das Objekt gedraget wurden. Wenn Dateitypen gedraget wurden, die 
akzeptiert werden, konnen Sie tiber andere Eigenschaften die Daten auslesen. 


2. Fiigen Sie folgenden Code in den DropObject-Event-Handler ein: 
Dim TextStream as TextInputStream 
If obj.FolderItemAvailable then 
Do 
TextStream=obj.FolderItem.OpenAsTextFile 
me.text=me.textt+TextStream. ReadAl 1+Chr(13) 
loop until not obj.nextItem 
End if 


3. Speichern Sie das Projekt unter TextEditor-Kapitel6. 


Die Eigenschaft FolderltemAvailable des Dragltem-Objekts ist True, wenn ein oder mehrere Folderltems (das sind 
die Textdokumente) gedraget wurden. 


Wenn ein Folderltem verftigbar ist, verwendet der Code die OpenAsTextFile-Methode der Folderltem-Klasse, um die 
Textdatei zu 6ffnen. Diese Methode liefert ein Objekt vom Typ TextInputStream, das den Inhalt der Textdatei enthalt. 
Die ReadAll-Methode wird verwendet, um den Inhalt des Folderltems an die Text-Eigenschaft von TextFeld anzuhin- 
gen. Die Chr-Funktion fiigt ein Return-Zeichen an das Ende des Textes an. 


Da der Anwender mehrere Dateien gleichzeitig draggen kann, wird die Do...Loop-Schleife verwendet, um diesen Pro- 
zess so lange zu wiederholen, bis keine weiteren akzeptierten Folderltems mehr verfiigbar sind. Die Next- 
Item-Methode weist den Eigenschaften des Dragltem-Objekts die Werte des nachsten verfiigbaren Objekts zu und 
liefert False, wenn keine weiteren passenden Objekte verbleiben. 


Testen der Applikation 
Nachdem Sie nun Drag & Drop eingebaut haben, kdnnen Sie die Applikation testen. 


1. Wahlen Sie Debug/Programm starten und experimentieren Sie mit verschiedenen Text-Dateien und Text-Clips. 
Sie werden bemerken, dass TextEditor gedraggte Objekte mit falschem Dateityp zuriickweist. 
Sie konnen auch Text im TextEditor selektieren und auf den Schreibtisch draggen, um einen Text-Clip zu erzeugen. 


2. Beenden Sie Ihr Programm, um in die Entwicklungsumgebung zurtickzukehren. 
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Ruckblick 


In diesem Kapitel haben Sie den TextEditor um Drag & Drop-Fahigkeiten erweitert. 


7. Arbeiten mit Text 


In diesem Kapitel werden Sie mit dem Styled-Text-Feature (Text mit Stilinformationen) von REALbasic arbeiten. Sie wer- 
den ein Stil-, Grdfse- und Farbe-Menii implementieren. Diese Mentis erlauben es dem Benutzer, einem selektierten Text 
einen bestimmten Schriftstil und eine bestimmte Schriftgr6&e zuzuweisen. Augerdem erfahren Sie, wie man im Menii 
ein Hakchen neben den gerade gewahlten Schriftstil und die gewahlte Schriftgr68e setzt, damit der Benutzer die aktuel- 
len Einstellungen ablesen kann. 


Im Kapitel 8 werden Sie ein Font-Menii hinzuftigen, das dem Anwender gestattet, jeden auf dem Rechner installierten 
Zeichensatz zu verwenden. Wenn Sie damit fertig sind, wird Ihr Dokument-Fenster folgendermafsen aussehen: 


(oS) Namenlos 
Schrift:| Geneva y Grige:[ 12 | {F] [x] fv Farbe: 
ASH News im Mai 2002 0 


Wie immer halten wir eine Fille an erfreulichen Meldungen und 
VorankUndigungen fiir Sie parat. Leider haben wir dieses mal auch zwei 
eher traurige Meldungen zu verkiinden: Zwei von vielen Gamern ersehnte 
Spiele werden nicht auf dem deutschen Markt erscheinen. Mehr dazu in 
den SPIELE-NEWS. Zum Ausgleich gibt es aber auch ein paar tolle 
Erfolgsmeldungen, so ist nun beispielsweise endlich die Mac OS X 
Version von Freeway 3.5 ab Lager lieferbar und unsere schlaue 
Serverlésung NetBerry hat sich in verschiedenen Tests ganz vorne 
platziert. AuRerdem gibt es natirlich eine Menge neuer Spiele, eine 
neue Version von iView MediaPro, lund, und, und... 


Viel Spa& beim Lesen. a 
Y 


Die Steuerelemente fiir die Schrift und die Schriftgr6%e sind Popup-Meniis, die Stil-Steuerelemente sind Kndpfe und das 
Farbe-Steuerelement ist ein Canvas-Control, das die Farbe des selektierten Textes anzeigt und die Farbauswahl aufruft, 
wenn der Anwender darauf klickt. 


Los geht's 
Laden Sie Ihr REALbasic-Projekt TextEditor-Kapitel6. 


Konfigurieren von TextFeld fiir Styled Text 


Bevor Sie die Stil- und Grd&e-Mentis implementieren, miissen Sie dem TextFeld beibringen, Text mit verschiedenen 
Stilen und Groen zu verarbeiten. Dazu miissen Sie fiir TextFeld die Styled-Eigenschaft setzen. AuSerdem miissen Sie 
den oberen Rand von TextFeld ein paar Pixel nach unten verschieben, damit Platz ftir die Steuerelemente entsteht. 


1. Flhren Sie einen Doppelklick auf den TextFenster-Eintrag im Projektfenster aus. 
Das Fenster 6ffnet sich im Fenster-Editor. Seine Eigenschaften werden im Eigenschaften-Fenster angezeigt. 

2. Klicken Sie auf das TextFeld im Fenster (also auf den weifSen Fensterhintergrund) und aktivieren Sie im Eigenschaf- 
ten-Fenster die Styled-Eigenschaft. Die Styled-Eigenschaft finden Sie im Abschnitt Aussehen. 
Ohne aktivierte Styled-Eigenschaft waren Sie nicht in der Lage, verschiedenen Textabschnitten verschiedene Stile 
zuzuweisen. 


3. Setzen Sie die Top-Eigenschaft von TextFeld auf 25. 
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4. Reduzieren Sie den Wert der Height-Eigenschaft um 26. 


Thr TextFenster sollte nun 


etwa so aussehen: 
eee Namenlos 


5. Speichern Sie das Projekt unter TextEditor-Kapitel7. 


Anlegen eines FontgroBe-Popup-Meniis 


In diesem Abschnitt erzeugen Sie ein Gro&e-Menii und seine Meniieintrage. 


Das GroBe-Menti und 


seine Menteintrage erzeugen 


1. Ziehen Sie ein Staticlext-Steuerelement £4 @ aus der Steuerelemente-Palette in den oberen Bereich von Text- 


Fenster. 


2. Stellen Sie die Eigenschaft 


en dieses Staticlext-Steuerelements wie folgt ein: 


Eigenschaft Wert 
Left 203 
Top 4 
Width 43 
Height 16 

Tex Groke: 
TextAlign Rechts 
TextFont System 
TextSize 0 

Bold True 


Sie fragen sich vielleicht, 


weshalb Sie die TextSize-Eigenschaft auf Null setzen sollen. Diese Eigenschaft legt die 


Grofe des sichtbaren Texts im StaticText fest. Sie konnen TextSize entweder auf eine bestimmte Schriftgr6&e oder 
auf Null setzen, um REALbasic mitzuteilen, dass es die Standardgr6fe fiir die Plattform verwenden soll, auf der Ihre 
Applikation lduft. Die optimale Schriftgr68e ftir eine Applikation ist unter Mac OS, Windows und Linux normaler- 
weise unterschiedlich. Wenn Ihre Applikation nur auf einer Plattform zum Einsatz kommen soll, konnen Sie natiirlich 
eine konkrete Schriftgrde vorgeben. 


3. Draggen Sie als nachstes ein BevelButton-Steuerelement @ad_rechts neben das StaticText-Steuerelement. 
Ein BevelButton kann entweder als PushButton oder als Popup-Menti konfiguriert werden und entweder Text oder 


ein Bild darstellen. 
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4. Stellen Sie mit dem Eigenschaften-Fenster folgende Werte fiir den BevelButton ein: 


Eigenschaft Wert 

Name GroesseMenue 

Left 251 

Top 4 

Width ue) 

Height 16 

Caption (leer lassen) 

CaptionAlign Zentriert 

CaptionPlacement ormal 

HasMenu ormales Menii 

TextFont System 

TextSize 
Die Eigenschaft HasMenu ftihrt dazu, dass sich der BevelButton wie ein Popup-Menii und nicht wie ein Knopf verhilt. 
Als nachstes miissen Sie die Mentieintrage erzeugen. Das soll zur Laufzeit des Programms genau dann geschehen, 


wenn das Fenster geoffnet wird. 


5. Offnen Sie im Code-Editor von TextFenster unter den Steuerelementen den Eintrag GroesseMenue und aktivieren 
Sie den Open-Event-Handler. 
6. Geben Sie folgenden Code in den Event-Handler ein: 
me.addrow "9" 
me.addrow "10" 
me.addrow "12" 
me.addrow "14" 
me.addrow "18" 
me.addrow "24" 
me.addrow "36" 
me. caption=Str(TextFeld.SelTextSize) 


Die ersten sieben Zeilen rufen jeweils die AddRow-Methode der BevelButton-Klasse auf, um in das Popup-Menii einen 
neuen Eintrag einzuftigen. Die letzte Zeile setzt den Vorgabewert der Caption-Eigenschaft auf die Schriftgr6&$e an der 
Cursorposition. Dabei konvertiert die Str-Funktion die Schriftgr6e des selektierten Textes im TextFeld (also einen Inte- 
ger-Wert)in einen String. Sie miissen diese Konvertierung vornehmen, da die Caption-Eigenschaft nur Strings akzeptiert. 
Wenn Sie versuchen, einen numerischen Wert zu tibergeben, erhalten Sie eine Fehlermeldung. 


Der Ausdruck Me verweist auf das Steuerelement, zu dem der Event-Handler gehort, also GroesseMenue. Sie hatten 
auch GroesseMenue.addrow schreiben konnen, wenn Sie jedoch Me verwenden, ist der Code universeller und kann 
in andere BevelButton-Steuerelemente kopiert werden, ohne dass er angepasst werden muss. Er funktioniert auSerdem 
auch dann noch, wenn Sie den Namen des Steuerelements adndern. 


Jetzt legen Sie noch fest, was passieren soll, wenn der Anwender einen Mentieintrag aufruft. Dies passiert im 
Action-Event-Handler von GroesseMenue. Er wird ausgefiihrt, wenn der Anwender in dem Menii eine Auswahl trifft. 


7. Geben Sie folgenden Code in den Action-Event-Handler ein: 


Me.Caption=Me.List(Me.MenuValue) 
TextFeld.SelTextSize=Val (Me.Caption) 


Die Eigenschaft MenuValue ist die Nummer des gewahlten Menitieintrags und die List-Methode liefert den Text des 
Meniieintrags, der zur tibergebenen Nummer gehdrt. Die erste Zeile setzt die Caption-Eigenschaft (der Text, der im 
Steuerelement angezeigt wird) auf die Schriftgrd8e, die der Anwender ausgewahlt hat. 
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Die zweite Zeile weist der SelTextSize-Eigenschaft von TextFeld die gewahlte Schriftgro&e zu. Damit wird die Groe von 
eventuell im Dokumentfenster selektiertem Text entsprechend geandert. Augerdem erscheint neu eingegebener Text in 
dieser Grofe. 


Austesten des GroBe-Mentis 


Speichern Sie Ihr Projekt und testen Sie es mit Debug/Programm starten. Tippen Sie ein paar Worter und versuchen 
Sie, die Schriftgr6%e zu andern. 


Ein ungeldstes Problem 


Wenn Sie verschiedenen Wortern verschiedene Schriftgrden zuweisen und den Cursor durch den Text bewegen, wer- 
den Sie bemerken, dass das Gréfe-Menii nicht die aktuelle Schriftgrde anzeigt. Das bedeutet, dass das GrdfSe-Menii 
mit dem TextFeld kommunizieren kann, aber keinerlei Riickmeldung von TextFeld tiber die Schriftgrd8e des selektierten 
Textes bekommt. Dieses Problem zeigt folgende Abbildung: 


"@ @¢ Namenlos 
GréRe: | 36~| 


Das ist + groRer werdenier LC x 0 


Das Gr6&e-Menii zeigt 36 an, da das Wort ,,Text“ zuvor in Grdfe 36 geschrieben wurde. Wenn dann der Cursor auf das in 
Gre 12 geschriebene , ein“ gesetzt wird, zeigt das GrofSe-Menti immer noch 36. Das ist natiirlich unschén. 


Das Fontgr6Be-Menii aktualisieren 


Um das Schriftgrofse-Menii zu aktualisieren, verwenden Sie den SelChange-Event von TextFeld. Er wird immer dann 
ausgeftihrt, wenn der Anwender die Textselektion andert. Das schliefst das Bewegen des Cursors ein. 


1. Offnen Sie den Code-Editor von ‘TextFenster, 6ffnen Sie das TextFeld-Steuerelement und wihlen Sie den 
SelChange-Event-Handler aus. 


2. Geben Sie folgenden Code in diesen Event-Handler ein: 


//FontgréBementi aktualisieren 
If Str(Me.SelTextSize) <> GroesseMenue.Caption then 
GroesseMenue. Caption=Str(Me.SelTextSize) 
GroesseMenue.MenuValue=FontgrdReMentiEinstellen(Me.SelTextSize) 
End if 


Der If-Befehl iiberpriift, ob die Schriftgr6e des selektierten Textes mit den aktuellen Einstellungen im Menii tiber- 
einstimmt. Wenn das nicht der Fall ist, werden die Caption- und MenuValue-Eigenschaften von GroesseMenue 
entsprechend gesetzt. Um letzteres zu bewerkstelligen, wird eine Funktion bendtigt, die die Schriftgrd&e des selek- 
tierten Textes in die Nummer des entsprechenden Meniieintrags konvertiert (die MenuValue-Eigenschaft reicht von 
null bis 6 und enthiilt nicht den Text des Meniieintrags). Die Methode FontgréBeMeniEinstellen ist cine einfache 
Funktion, die die Konvertierung vornimmt. Sie mtissen diese nun dem Projekt hinzuftigen. 


3. Rufen Sie fiir den Code-Editor von TextFenster den Mentipunkt Bearbeiten/Neue Methode auf. Die Dialogbox 
Neue Methode erscheint. 
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4. Geben Sie den Namen Fontgr6BeMeniEinstellen, den Parameter FontGréBe As Integer und den Riickgabetyp 
Integer ein. Die Dialogbox sollte so aussehen: 


Methode: Fontgré&eMeniEinstellen @ 


Parameter: FontGrofe As Integer| 


Riickgabetyp: Integer 


Giiltigkeitsbereich: | Offentlich (Uberall) 


& 
@) 
( Abbrechen ) co 


Wenn Sie auf OK klicken, dffnet der Code-Editor von TextFenster die Fontgr6BeMeniEinstellen-Methode. 


5. Geben Sie folgenden Code in den Code-Editor ein: 
Dim s as Integer 
Select case FontGréBe 


s=5 
case 36 
s=6 
end select 
Return s 
Der Select Case-Befehl ermittelt aus dem der Methode tibergebenen Parameter (der Fontgréfe) die Nummer des ent- 


sprechenden Meniieintrags, weist diese der Variablen s zu und liefert diese zuriick. 


6. Testen Sie das Programm mit Debug/Programm starten. Wenn Sie den Cursor durch einen Text mit unterschiedli- 
chen Schriftgr6&en bewegen, aktualisiert sich das Gro&e-Menti automatisch. 


Implementieren des Stil-Meniis 


Als nachstes miissen Sie die drei Knopfe rechts vom Grofse-Menii hinzufiigen, damit der Anwender die Stile Fett, Kursiv 
und Unterstrichen zuweisen kann. Zusatzlich kGnnten Sie auch noch die Stile Konturschrift, Schattiert, Eng und 
Breit verwenden, diese werden allerdings nur unter Mac OS und nicht unter Windows unterstiitzt. In diesem Tutorial 
implementieren Sie nur die drei Basis-Stile. 


Sie verwenden fiir den Font-Stil ebenfalls BevelButtons. Diesmal fungieren sie jedoch als Knopfe und nicht als 
Popup-Menus. 
Die Stil-Buttons erzeugen 


1. VergroSern Sie TextFenster, indem Sie den Vergroerungsknopf nach rechts ziehen, um Platz fiir die zusatzlichen 
Steuerelemente zu schaffen. 


2. Draggen Sie ein BevelButton-Steuerelement @ad aus der Steuerelemente-Palette in den Kopfbereich von Text- 
Fenster, rechts neben das Gro&e-Menii. 
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3. Stellen Sie seine Eigenschaften im Eigenschaften-Fenster auf folgende Werte: 


Eigenschaft Wert 
Name KnopfFett 
Left 340 

Top 4 

Width 16 

Height 16 
Caption F 
CaptionAlign Zentriert 
TextFont System 
TextSize 9 

Bold True 
Italic False 
Underline False 
Buttonlype Umschalter 


4. Duplizieren Sie den Knopf zweimal (Befehlstaste-D bzw. Strg-D), bewegen Sie die neuen Knopfe auf ihr ungefahren 


Positionen rechts neben den Fett-Knopf und stellen Sie deren Eigenschaften folgendermafen ein: 


Eigenschaft Kursiv-Knopf Unterstrichen-Knopf 

Name KnopfKursiv KnopfUnterstrichen 

Left 370 400 

Top 4 4 

Width 16 16 

Height 16 16 

Caption K U 

CaptionAlign Zentriert Zentriert 

HasMenu Kein Meni Kein Menti 

TextFont System System 

TextSize 9 9 

Bold False False 

Italic True False 

Underline False True 

ButtonType Umschalter Umschalter 
Als nachstes schreiben Sie den Programmcode fiir die drei Kndpfe. Dies machen Sie im Action-Event-Handler eines 
jeden Knopfes. Dieser wird ausgeftihrt, wenn der Anwender auf den Knopf klickt. 


5. Aktivieren Sie im Code-Editor von TextFenster den Action-Event-Handler von KnopfFett und fiigen Sie folgende 
Code-Zeile hinzu: 
TextFeld.ToggleSelectionBold 
Diese Zeile schaltet das Fett-Attribut von selektiertem Text um. Ist der selektierte Text bereits fett, wird das Fett-Attri- 
but entfernt. Ist der Text noch nicht fett, wird das Fett-Attribut gesetzt. 
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6. Schreiben Sie folgende Zeile in den Action-Event-Handler von KnopfKursiv: 
TextFeld.ToggleSelectionItalic 


7. Schreiben Sie folgende Zeile in den Action-Event-Handler von KnopfUnterstrichen: 
TextFeld.ToggleSelectionUnderline 


8. Speichern Sie Thr Projekt. 


Die Stil-Steuerelemente aktualisieren 


Als letzten Schritt mtissen Sie den Code hinzuftigen, der die Knopfe Fett, Kursiv und Unterstrichen aktualisiert, wenn der 
Anwender den Cursor im Text bewegt. 


Hierzu miissen Sie zusdtzlichen Code in den SelChange-Event-Handler von TextFeld eingeben. Dieser Event wird 
immer ausgeftihrt, wenn sich die Selektion geandert hat. 


1. Expandieren Sie im Code-Editor von TextFenster den Eintrag Steuerelemente und expandieren dort den Text- 
Feld-Eintrag. 


2. Klicken Sie auf SelChange und ftigen Sie folgenden Code hinter den bereits vorhandenen ein: 


//Stil-Knoépfe aktualisieren 
If Me.Selbold <> KnopfFett.Value then 
KnopfFett.Value=Me.SelBold 


If Me.Selltalic <> KnopfKursiv.Value then 
Knopfkursiv.Value=Me.SelItalic 


If Me.SelUnderline <>KnopfUnterstrichen.Value then 
KnopfUnterstrichen.Value=Me.SelUnderline 
End if 


Jeder If-Befehl tiberpriift, ob der Zustand eines Knopfes zu dem Stil-Attribut des selektierten Textes passt. Ist dies nicht 
der Fall, wird der Knopf entsprechend gedndert. Wenn zum Beispiel die Value-Eigenschaft von KnopfFett True, der 
selektierte Text aber nicht fett ist, setzt der Code die Value-Eigenschaft von KnopfFett auf False. 


Der SelChange-Event-Handler sollte nun folgendermafsen aussehen: 


(Rok s) Code Editor (TextFenster) 


v WTextFeld 


= Sub SelChange() 
‘| Close 


//Fontgré&ement aktualisieren 


| DropObject If Str(Me.SelTextSize) <> GroesseMenue.Caption then 

™\ GotFocus GroesseMenue.Caption=Str(Me.SelTextSize) 

“\ KeyDown GroesseMenue.MenuValue=FontgréReMeniEinstellen(Me.SelTextSize) 
“S\ LostFocus End if 

= MouseDown //Stil-Knépfe aktualisieren 


If Me.Selbold <> KnopfFett.Value then 
| KnopfFett.Value=Me.SelBold 
End if 
L If Me.Selitalic <> KnopfKursiv.Value then 
MouseUp KnopfKursiv.Value=Me.Selltalic 
pen End if 
elChange If Me.SelUnderline <>KnopfUnterstrichen.Value then 
‘extChange KnopfUnterstrichen.Value=Me.SelUnderline 
End iff 
End Sub 


“| MouseEnter 
“S\ MouseExit 
“| MouseMove 


SE) + » 


Testen der Stil- und GroBe-Steuerelemente 
Nachdem nun der Code eingegeben ist, konnen Sie ausprobieren, ob er funktioniert. 
1. Rufen Sie Debug/Programm starten auf und geben Sie Text in den Text-Editor ein. 


2. Selektieren Sie etwas Text und versuchen Sie, seine Grof&e und seinen Stil zu andern. 
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Wenn ein Stil selektiert ist, ist der zugeh6rige Knopf ausgewahlt. Verwendet der Text keinen Stil, ist keiner der drei 
Knopfe ausgewahlt. Sollte sich Ihr Programm anders verhalten, haben Sie vermutlich vergessen, die ButtonType-Ei- 
genschaft auf Umschalter zu stellen. 


(see) Namenlos 
GrdRe: | 184] fF] [x] 


fe 


Das ist ein T@St-Text. 


3. Beenden Sie Ihr Programm, um in die Entwicklungsumgebung zurtickzukehren. 


Ein Farbe-Steuerelement implementieren 


In diesem Abschnitt fiigen Sie ein Farbe-Steuerelement hinzu, das dem Anwender gestattet, dem Text ein Farbattribut 
zuzuweisen. Sie verwenden hierzu ein Canvas-Steuerelement. 


Das Canvas-Steuerelement ist eine leere ,,Leinwand“, die mit Zeichenwerkzeugen ausgestattet ist, mit denen man das 
Erscheinungsbild des Steuerelements beeinflussen kann. Als Zeichenwerkzeuge stehen die Methoden der 
Graphics-Klasse zur Verftigung. Mit den Zeichenwerkzeugen zeichnen Sie einen schwarzen Rahmen um das Steuerele- 
ment und fiillen diesen mit der Farbe des selektierten Textes. Das Steuerelement bekommt auch eine Aufgabe — es soll 
die Farbauswahl aufrufen, wenn der Anwender darauf klickt. Es wird also wie ein PushButton funktionieren, verwendet 
aber die Methoden der Graphics-Klasse, um sein Aussehen zu steuern. 


So fiigen Sie das Farbe-Steuerelement hinzu: 
1. Klicken Sie auf das StaticText-Objekt, das als Beschriftung fiir das GrofSe-Menti dient und duplizieren Sie es. 


2. Ziehen Sie das Duplikat rechts neben den Unterstrichen-Knopf und richten Sie es mit der Basis-Linie der anderen 
Objekte aus. Andern Sie seine Text-Eigenschaft auf Farbe:, setzen Sie die Left-Eigenschaft auf 435 und seine 
Width-Eigenschaft auf 40. 


3. Draggen Sie ein Canvas-Steuerelement pe | aus der Steuerelemente-Palette rechts neben das StaticText-Objekt 
(ignorieren Sie, dass das Canvas ein wenig zu grof ist) und stellen Sie mit dem Eigenschaften-Fenster folgende Werte 
dafiir ein: 


Eigenschaft Wert 
Name KnopfFarbe 
Left 482 

Top 4 

Width 57 

Height 16 


Die nachsten Schritte zeichnen einen schwarzen Rahmen und fiillen das Canvas-Steuerelement mit der Default-Text- 
farbe. 


1. Expandieren Sie die Event-Handler von KnopfFarbe im Code-Editor und selektieren Sie den Paint-Event. Eine 
schnellere Méglichkeit ist, KnopfFarbe zu selektieren und alt-Tab zu driicken. 


Der Paint-Event wird immer dann ausgefiihrt, wenn REALbasic bemerkt, dass das Canvas-Steuerelement neu 
gezeichnet werden muss. 

Sie werden bemerken, dass der Methode fiir den Paint-Event ein Parameter g as Graphics iibergeben wird. Sie ver- 
wenden diesen Parameter, um Zugriff auf die Zeichenwerkzeuge der Graphics-Klasse zu bekommen. 
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2. Geben Sie folgenden Code in den Paint-Event ein: 
g.ForeColor=rgb(0,0,0) // schwarz 
g.DrawRect(0,0,g.Width-1,g.Height-1) 
g.ForeColor=TextFeld.SelTextColor 
g.FillRect(1,1,g.Width-2,g.Height-2) 
Jede Zeile greift auf eine Methode oder Eigenschaft der Graphics-Klasse zu. Die ForeColor-Eigenschaft legt die 
Farbe fest, die ftir darauf folgenden Aufrufe von Methoden der Graphics-Klasse verwendet wird. Die RGB-Funktion 
verwendet das Rot-Griin-Blau-Farbmodell, um der ForeColor-Eigenschaft eine Farbe zuzuweisen. Ihre Parameter 
sind die Farbanteile fiir Rot, Griin und Blau. Die ForeColor-Eigenschaft selbst zeichnet nichts. 


Die erste Code-Zeile setzt ForeColor auf Schwarz und die nachste Zeile zeichnet einen schwarzen Rahmen um die 
Kanten des Steuerelements. Die vier Parameter sind die linken und oberen Koordinaten des zu zeichnenden Recht- 
ecks und die Breite und Hohe des Rechtecks. Die Eigenschaften Width und Height liefern die aktuelle Breite und 
Hohe der Zeichenregion zuriick. Es ist besser, Width und Height zu verwenden, als absolute Werte in den Code zu 
schreiben. Sollte sich die Gro&e des Steuerelements einmal dndern, miissen Sie diese Code-Zeilen nicht anpassen. 


Die nachsten beiden Zeilen setzen die ForeColor-Eigenschaft auf die in TextFeld aktuelle Textfarbe und fiillen den 
Inhalt des Canvas-Steuerelements mit dieser Farbe. 


Der nachste Schritt besteht darin, das Verhalten des Canvas-Steuerelements dem eines PushButtons nachzuempfinden. 
Sie verwenden dazu den MouseDown-Event-Handler des Canvas-Steuerelements. Fiir unsere Zwecke funktioniert er 
wie der Action-Event-Handler des BevelButton-Steuerelement. Er wird ausgeftihrt, wenn der Anwender in das Can- 
vas-Steuerelement klickt. Sie werden bemerken, dass die Koordinaten des Mausklicks zuriickgeliefert werden, Sie diese 
jedoch nicht benutzen miissen. 


3. Selektieren Sie den MouseDown-Event-Handler des Canvas-Steuerelements und fiigen Sie folgenden Code ein: 
Dim c as Color 
Dim b as Boolean 
c=rgb(255,255,255) // Default-Farbe 
b=SelectColor(c,"Wdhle eine Textfarbe") 
If b then 
Me.Graphics.ForeColor=c 
Me.Graphics.FillRect(1,1,Me.Graphics.Width-2,Me.Graphics.Height-2) 
TextFeld.SelTextColor=c 
End if 


Die SelectColor-Funktion ruft die Farbauswahl auf. Sie erwartet zwei Parameter, eine Farbe und einen Textstring, der 
innerhalb der Farbauswahl dargestellt wird. Die Farbe, die Sie an SelectColor iibergeben, steuert das Aussehen des 
Farbkreises, der anfangs im Dialog erscheint. SelectColor liefert einen boole’schen Wert, der True ist, wenn der Anwen- 
der auf OK geklickt hat und False, wenn er die Dialogbox mit Abbrechen verlassen hat. 


Wenn der Anwender auf OK geklickt hat, wird die gewahlte Farbe in ¢ zuriickgeliefert. 


Der Wert von c, der von SelectColor zuriickgeliefert wird, unterscheidet sich von dem, der tibergeben wurde (vorausge- 
setzt, der Anwender hat eine andere Farbe gewahlt). Dies ist mdglich, da der Color-Parameter als Referenz und nicht als 
Wert tibergeben wird. Deshalb ist SelectColor in der Lage, den Wert zu andern und die Referenz zurtickzuliefern. 


Sie konnen auch in eigenen Methoden die Ubergabe als Referenz verwenden, indem Sie das REALbasic-Schliisselwort 
ByRef cinsetzen. Weitere Informationen dazu finden Sie in der Sprachreferenz. 


Das Steuerelement aktualisieren 


Sie haben vermutlich schon damit gerechnet, dass Sie nun noch Code in das SelChange-Event von TextFeld einfiigen 
miissen, um die Farbe im Canvas-Steuerelement zu aktualisieren, wenn der Cursor auf ein Zeichen bewegt wird, das eine 
andere Farbe besitzt. 
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1. Klicken Sie im Code-Editor auf das zweite Icon unter dem Browser-Bereich i, welches ,Verstecke leere Methoden“ 
genannt wird. 
Der Browser zeigt nun nur noch Methoden an, die Code enthalten. Dies macht die Navigation zu Methoden, die mo- 
difiziert werden miissen, einfacher. 


Code Editor (TextFenster) 


Function MouseDown(X As Integer, Y As Integer) As Boolean 
Dim c as Color 
Dim b as Boolean 
c=rgb(255,255,255) // Default-Farbe 


> [|KnopfFett b=SelectColor(c,"Wahle eine Textfarbe") 
> [4 ]Knopfkursiv If b then 
> fy] KnopfUnterstrichen Me.Graphics.ForeColor=c 
a Me.Graphics.FillRect( 1,1 ,Me.Graphics.Width-2,Me.Graphics.Height-2) 
vy WTextFeld 
TextFeld.SelTextColor=c 
End iff 
End Function 

4 

’ 
& El lel » 


2. Klicken Sie auf den SelChange-Event des TextFeld-Objekts und erginzen Sie den vorhandenen Code folgender- 
mafen: 
//Farbanzeige aktualisieren 
If Me.SelTextColor <> KnopfFarbe.Graphics.ForeColor then 
KnopfFarbe.Graphics.ForeColor=Me.SelTextColor 
KnopfFarbe.Graphics.FillRect(1,1,KnopfFarbe.Graphics.Width-2,KnopfFarbe.Graphics .Height-2) 
End if 


Der Code-Editor sollte nun so aussehen: 


Code Editor (TextFenster) 


nesseMience Sub SelChange() 
KnopfFarbe //FontgréRemenii aktualisieren 

MouseDown If Str(Me.SelTextSize) <> GroesseMenue.Caption then 

Paint GroesseMenue.Caption=Str(Me.SelTextSize) 
>  [|KnopfFett GroesseMenue.MenuValue=FontgréReMenUEinstellen(Me.SelTextSize) 
> — [s)Knopfkursiv End if 
> [5] KnopfUnterstrichen //Stil-Kndépfe aktualisieren 
y DoTextFeld If Me.Selbold <> KnopfFett.Value then 


KnopfFett.Value=Me.SelBold 


=) DropObject End if 
Open If Me.Selitalic <> KnopfKursiv.Value then 
SelChange | KnopfKursiv. Value=Me. Selltalic 
TextChange End if 
If Me.SelUnderline <>KnopfUnterstrichen.Value then 
KnopfUnterstrichen. Value=Me.SelUnderline 
End if 
//Farbanzeige aktualisieren 
If Me.SelTextColor <> KnopfFarbe.Graphics.ForeColor then 
KnopfFarbe.Graphics.ForeColor=Me.SelTextColor 
KnopfFarbe.Graphics.FillRect(1,1 ,KnopfFarbe.Graphics.Width-2,KnopfFarbe Graphics.Height-2) 
4 End if 
Y End Sub 
i El el 


Der Code folgt folgender Logik: Wenn die Farbe des vorhandenen Textes sich von der aktuellen ForeColor-Eigenschaft 
des Canvas-Steuerelements unterscheidet, wird die ForeColor-Eigenschaft aktualisiert und die FillRect-Methode der Gra- 
phics-Klasse verwendet, um das Innere des Canvas-Steuerelements neu zu zeichnen. 


Das Farbe-Steuerelement testen 
Nachdem der benGtigte Code an seinem Platz ist, k6nnen Sie nun ausprobieren, ob alles funktioniert: 
1. Wahlen Sie Debug/Programm starten und geben Sie etwas Text in den TextEditor ein. 
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2. Selektieren Sie etwas Text und versuchen Sie, dessen Farbe zu andern. 
"e28 Namenlos 
GréRe: | 18¥ F] [x] [v]  Farbe: EE) 


In der Roten Zone ist Parkverbot| 


3. Beenden Sie Ihr Programm, um zur Entwicklungsumgebung zurtickzukehren. 


Ruckblick 


In diesem Kapitel haben Sie die Steuerelemente StaticText, Separator, BevelButton und Canvas kennengelernt. 


8. Erzeugen von dynamischen Menis 


In diesem Kapitel werden Sie lernen, wie man ein Menii erzeugt, dessen Eintrge erst zur Laufzeit festgelegt werden. Sie 
werden ein Schrift-Menti programmieren, das eine Liste aller installierter Zeichensatze anzeigt. Im Gegensatz zum 
Gr6fe-Menii konnen Sie die Eintrage des Schrift-Mentis nicht im voraus festlegen, da Sie nicht wissen, welche Schriften 
der Anwender auf seinem Rechner installiert hat. 


Los geht's 
Suchen Sie die REALbasic-Projektdatei, die Sie am Ende des letzten Kapitels gespeichert haben (TextEditor-Kapitel7). 


Starten Sie REALbasic und 6ffnen Sie das Projekt. Falls notig, verwenden Sie die mitgelieferte Datei 
TextEditor-Kapitel7, die Sie im Ordner Tutorial Projekt finden. 


Implementierung des Schrift-Meniis 


Das Schrift-Menti verwendet die gleichen Techniken, die Sie in den Kapiteln zuvor kennengelernt haben. Der feine 
Unterschied ist, dass Sie eine Methode programmieren miissen, die die Namen der installierten Zeichensitze in ein 
Array einliest. Diese Methode wird ausgeftihrt, wenn ein Dokumentfenster geoffnet wird. 


Zuerst fiigen Sie das Schrift-Menti in den Kopfbereich von TextFenster ein: 


1. Draggen Sie ein StaticText-Steuerelement £4 Q aus der Steuerelemente-Palette links in den Kopf-Bereich von Text- 
Fenster und richten Sie die Grundlinie mit den Grundlinien der anderen StaticText-Steuerelemente aus, wie in fol- 
gender Abbildung gezeigt: 


eee Namenlos 
= SS SSS = 1 es SS Eee ee 


2. Andern Sie im Eigenschaften-Fenster das Staticlext-Steuerelement wie folet: 


Eigenschaft Wert 
Left 7 
Top 4 
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3: 


4, 


5. 


Eigenschaft Wert 
Width 45 
Height 16 

Tex Schrift: 
TextAlign Rechts 
TextFont System 
TextSize 0 

Bold True 


Draggen Sie ein BevelButton-Steuerelement @#ad aus der Steuerelemente-Palette rechts neben den Text 
,»schrift:“ und richten Sie seine obere Kante mit den anderen Steuerelementen aus. 


Andern Sie im Eigenschaften-Fenster die Eigenschaften des BevelButtons wie folet: 


Eigenschaft Wert 

Name SchriftMenue 
Left 55 

Top 4 

Width 140 

Height 16 

Caption (leer lassen) 
CaptionAlign Zentriert 
HasMenu Normales Menii 
TextFont System 
TextSize 0 


Speichern Sie Ihr Projekt unter TextEditor-Kapitel8. 


Aufbauen des Schrift-Mentis 


Die Meniieintrige des Schrift-Mentis werden generiert, wenn der Benutzer eine neue Instanz von TextFenster offnet. 
Daher miissen Sie den notwendigen Programmcode in den Open-Event-Handler von SchriftMenue einbauen. 


1. 


Selektieren Sie das Steuerelement SchriftMenue im TextFenster und driicken Sie alt-Tab. 
Es Offnet sich der Code-Editor ftir TextFenster und der Action-Event von SchriftMenue ist selektiert. 
Falls der Action-Event von SchriftMenue nicht selektiert ist, klicken Sie am unteren Rand des Browsers auf das Icon 


[=], um die leeren Methoden anzeigen zu lassen. 


Selektieren Sie den Open-Event-Handler und ftigen Sie dort folgenden Code ein: 
Dim i, nFonts as Integer 
nFonts=FontCount-1 
For i=0 to nFonts 
me.AddRow Font(7) 
Next 
me.Caption=TextFeld.SelTextFont 


Die FontCount-Funktion liefert die Anzahl der installierten Zeichensatze. Die Font-Funktion liefert den Namen des i-ten 
Zeichensatzes. Die AddRow-Methode der BevelButton-Klasse fiigt dem Menii einen neuen Eintrag hinzu und erwartet 
den Text des Meniieintrags als Parameter. Die For...Next-Schleife wird so oft durchlaufen, bis alle Zeichensatznamen hin- 
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zugefiigt wurden. Da Mentieintrage mit Null beginnend durchnummeriert werden, lauft die Schleife von Null bis Font- 
Count-1 und nicht von 1 bis FontCount. 


Die letzte Zeile setzt den Defaultwert der Caption-Eigenschaft des Schrift-Mentis auf den Default-Font von TextFeld, also 
auf den Wert, den die TextFont-Eigenschaft von TextFeld hat. 


Verwalten des Schrift-Mentis 


Das Schrift-Menti muss die Schriftart des ausgewahlten Textes auf die Schriftart andern, die der Anwender im Popup aus- 
gewahlt hat. Dies wird mit der SelTextFont-Eigenschaft von TextFeld erledigt. Im Popup soll ferner ein Hakchen neben 
der ausgewahlten Schrift erscheinen. 


1. Expandieren Sie den Action-Event fiir SchriftMenue im TextFenster-Code-Editor. 


2. Geben Sie folgenden Code ein: 


Me.Caption=Me.List(Me.MenuValue) 
TextFeld.SelTextFont=SchriftMenue. Caption 


Die MenuValue-Eigenschaft ist die Nummer des selektierten Mentieintrags. Die List-Methode liefert den Text des zur 
Nummer gehGrenden Meniieintrags. Die erste Zeile setzt die Caption-Eigenschaft, also den Text, der im Popup ange- 
zeigt wird, auf den Zeichensatz, den der Anwender ausgewahlt hat. 


Die zweite Zeile weist der SelTextFont-Eigenschaft von TextFeld (und damit dem aktuell selektierten Text) die gewahlte 
Schrift zu. Neu eingegebener Text erscheint in der ausgewahlten Schrift. 


Aktualisieren des Schrift-Mentis 


Der letzte Schritt besteht darin, das Schriftmenii zu aktualisieren, wenn der Cursor durch den Text bewegt wird. Da das 
Bewegen des Cursors die Textselektion dndert, verwenden Sie hierzu den SelChange-Event von TextFeld. 


1. Expandieren Sie den TextFeld-Eintrag im Code-Editor von TextFenster und selektieren Sie den SelChange-Event. 


2. Fiigen Sie an dessen Ende folgenden Code ein: 
//Schrift-Menti aktualisieren 
If Me.SelTextFont <> SchriftMenue.Caption then 
SchriftMenue.Caption=Me.SelTextFont 
SchriftMenue.MenuValue=SetzeSchri ftMenti(me.SelTextFont ) 


End if 
Die SelChange-Methode sollte nun etwa so aussehen: 

eee Code Editor (TextFenster) 

> = Aa StaticText2 Sub SelChange() 

> Aa StaticText3 //Fontgré&ementi aktualisieren 

vy OTextFeld If Str(Me.SelTextSize) <> GroesseMenue.Caption then 
™ Close GroesseMenue.Caption=Str(Me.SelTextSize) 
=) DropObject GroesseMenue.MenuValue=FontgréReMentEinstellen(Me.SelTextSize) 
™) GotFocus End if 
“ KeyDown //Stil-Knépfe aktualisieren 


If Me.Selbold <> KnopfFett.Value then 
KnopfFett.Value=Me.SelBold 

End if 

If Me.Selitalic <> KnopfKursiv.Value then 


™ LostFocus 
“) MouseDown 
“S MouseEnter 
“) MouseExit KnopfKursiv.Value=Me.Selltalic 
“S| MouseMove End if 
“S\ MouseUp | If Me.SelUnderline <>KnopfUnterstrichen. Value then 
Open KnopfUnterstrichen.Value=Me.SelUnderline 
SelChange End if 
TextChange //Farbanzeige aktualisieren 
If Me.SelTextColor <> KnopfFarbe.Graphics.ForeColor then 
KnopfFarbe.Graphics.ForeColor=Me.SelTextColor 
KnopfFarbe.Graphics.FillRect( 1,1 ,KnopfFarbe.Graphics.Width-2,KnopfFarbe.Graphics.Height-2) 
End if 
//Schrift-Menu aktualisieren 
If Me.SelTextFont <> SchriftMenue.Caption then 
SchriftMenue.Caption=Me.SelTextFont 
SchriftMenue.MenuValue=SetzeSchriftMeni(me.SelTextFont) 
4 End iff 
Md End Sub 


Bele» 
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Der If-Befehl tiberpriift, ob der aktuelle Zeichensatz von dem im Schrift-Menti abweicht. Ist dies der Fall, stellt die 
nachste Zeile die Caption-Eigenschaft neu ein. Die zweite Zeile ist notig, um das Hakchen zu aktualisieren, das Sie 
sehen, wenn Sie das Schrift-Menti aufrufen. Die MenuValue-Eigenschaft ist die Nummer des gewahlten Zeichensatzes, 
daher bendtigen Sie die fortlaufende Nummer, die zu diesem Zeichensatz gehért. Diese ermittelt die 
SetzeSchriftMent-Methode. Diese miissen Sie TextFenster noch hinzuftigen: 


1. Wahlen Sie, wahrend der Code-Editor von TextFenster das oberste Fenster ist, Bearbeiten/Neue Methode. 
2. Nennen Sie die Methode SetzeSchriftMent, geben Sie als Parameter Schrift as String und als Riickgabetyp 
Integer ein. Die Dialogbox sollte nun so aussehen: 


Methode: | SetzeSchriftMend| i) 


Parameter: Schrift As String 


Riickgabetyp: Integer 


Giltigkeitsbereich: ' Offentlich (Uberall) 


&) 
™ 
(Abbrechen ) (50K 


3. Klicken Sie auf OK. 


Beachten Sie, dass es sich bei dieser Methode um eine Funktion handelt, da Sie einen Riickgabetyp und einen Para- 
meter (Font) definiert haben. 


4. Geben Sie folgenden Code in diese Methode ein: 
Dim i, nFonts as Integer 
nFonts=Fontcount-1 
For i=0 to nFonts 
If Schrift=TextFenster.SchriftMenue.list(i) then 
Return i 
Exit 
End if 
Next 


5. Speichern Sie das Projekt. 
Die neue Methode sollte folgendermafsen aussehen: 


e668 TextFenster Quellcode 
> (B Eigenschaften = 
> 9 Events Function SetzeSchriftMenu(Schrift As String) As Integer 


a Dim i, nFonts as Integer 

if Konstarten nFonts=Fontcount- | 

> ey More-tendior For i=0 to nFonts 

v B Methoden If Schrift=TextFenster.SchriftMenue.list(i) then 
ateiSichern Return i 

FontgréKeMeniEinste. Exit 

*) SetzeSchriftMeni End if 


> BB Notizen Next 

¥ G@ Steuerelemente Pod runecan 
> [|] GroesseMenue a 

> [Bj KnopfFarbe v 

OF « » 


Im SelChange-Event-Handler wird die Funktion mit dem Namen des aktuellen Zeichensatzes als Parameter aufgerufen. 


Die For...Next-Schleife vergleicht diesen mit den Namen aller auf dem Rechner installierten Zeichensatze, bis es den pas- 
senden findet. Dann gibt es die laufende Nummer i zuriick und verlasst die Schleife mit dem Exit-Befehl. 


Nachdem der SelChange-Event-Handler die laufende Nummer ermittelt hat, kann er diese der MenuValue-Eigenschaft 
des SchriftMenues zuweisen. Dadurch wird das Hakchen im Schrift-Menti korrekt gesetzt. 


Testen der Applikation 


Nachdem nun die gesamte Werkzeugleiste fertig ist, konnen Sie die Applikation testen. 
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1. Wahlen Sie Debug/Programm starten und experimentieren Sie mit verschiedenen Schriften, Schriftgrofsen, Stilen 
und Farben. 


2. Beenden Sie Ihr Programm, um zur Entwicklungsumgebung zuriickzukehren. 


Ruckblick 


In diesem Kapitel haben Sie gelernt, wie man Meniieintrége in einem Programm dynamisch erzeugt. 


9. Drucken von Text mit Stilinformationen 


Nachdem Sie nun Text eingeben k6nnen und dessen Schriftart, Schriftstil, Schriftgr{se und Farbe frei festlegen konnen, 
fehlt eigentlich nur noch die Méglichkeit, den Text auszudrucken. 


In diesem Abschnitt geht es darum, die Mentipunkte Seitenformat und Drucken zu implementieren. 


Offnen Sie die REALbasic-Projektdatei, die Sie am Ende des letzten Kapitels gespeichert haben (TextEditor-Kapitel8). 
Falls notig, verwenden Sie die mitgelieferte Datei TextEditor-Kapitel8, die Sie im Ordner Tutorial Projekt finden. 


Hinzufiigen der Meniipunkte Seitenformat und Drucken 
Um diese Meniipunkte einzurichten, gehen Sie folgendermafen vor: 


1. Offnen Sie den Meniieditor und selektieren Sie den leeren Eintrag am Ende des Ablage-Meniis (Windows: des 
Datei-Meniis). 


2. Tragen Sie im Eigenschaften-Fenster als ‘Text-Eigenschaft Seitenformat... und als Name-Eigenschaft 
AblageSeitenformat (ohne die drei Punkte am Schluss) ein. 


3. Deaktivieren Sie die AutoEnable-Eigenschaft. 


4. Selektieren Sie den leeren Meniieintrag am Ende des Ablage-Meniis (Windows: des Datei-Meniis), geben Sie als 
Text-Eigenschaft Drucken... und als Name-Eigenschaft AblageDrucken (wieder ohne die drei Punkte) ein. 


Weisen Sie der CommandKey-Eigenschaft den Buchstaben P zu. 
Deaktivieren Sie die AutoEnable-Eigenschaft. 
Positionieren Sie die beiden neuen Mentipunkte zwischen den Sichern unter- und Beenden-Meniipunkten. 


09" SGN SO 


Selektieren Sie den leeren Meniieintrag am Ende des Ablage-Meniis (Windows: des Datei-Meniis) und geben Sie als 
Text-Eigenschaft ein Minus (,-“) ein. Dadurch erzeugen Sie einen Separator zwischen Gruppen von Meniiintragen. 


9. Draggen Sie den Separator zwischen die Sichern unter- und Seitenformat-Meniipunkte. 

10. Erzeugen Sie einen zweiten Separator und draggen Sie ihn zwischen die Drucken- und Beenden-Meniipunkte. 
11. SchlieSen Sie den Menii-Editor. 

12. Speichern Sie das Projekt unter TextEditor-Kapitel9. 


Aktivieren der Menipunkte Seitenformat... und Drucken... 

Diese Meniipunkte sollen immer dann aufrufbar sein, wenn ein Dokumentfenster ged6ffnet ist. Deshalb werden sie im 
Code-Editor fiir TextFenster aktiviert: 

1. Klicken Sie im Code-Editor-Browser von TextFenster auf das Dreieck vor dem Events-Eintrag. 


2. Selektieren Sie den EnableMenultems-Event und erganzen Sie den vorhandenen Code um folgende Anweisungen: 


AblageSeitenformat.Enable 
AblageDrucken. Enable 
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Verwalten des Seitenformat-Meniipunkts 


Damit Sie die Einstellungen verwenden kénnen, die der Anwender im Seitenformat-Dialog vornimmt, bendtigen Sie ein 
PrinterSetup-Objekt. Dieses Objekt hat die Eigenschaft SetupString, die viele dieser Einstellungen speichert. Der 
erste Schritt besteht darin, diese Eigenschaft im Code-Editor fiir TextFenster anzulegen. 


1. Rufen Sie den Mentipunkt Bearbeiten/Neue Eigenschaft auf und geben Sie folgendes in die erscheinende Eigen- 


schaften-Definitionsbox ein: Seitenformat as String. Wahlen Sie als Giiltigkeitsbereich Geschiitzt (Textfenster 
und Unterklassen). 


2. Klicken Sie auf OK, um das Fenster zu schliefen. 
Als nachstes werden Sie den Menu-Handler fiir den Seitenformat-Mentipunkt programmieren. 
1. Rufen Sie Bearbeiten/Neuer Menu-Handler auf und wahlen Sie aus dem Popup-Menii AblageSeitenformat aus. 


2. Geben Sie folgenden Programmcode fiir den Seitenformat-Menti-Handler ein: 
Dim ps as PrinterSetup 
ps=New PrinterSetup 
If Seitenformat<>"" then 
ps.setupstring=Seitenformat 
End if 
If ps.PageSetupDialog then 
Seitenformat=ps.SetupString 
end if 


Die PrinterSetup-Eigenschaft, SetupString, speichert die Einstellungen, die der Anwender in der Seitenformat-Dialog- 
box vornimmt. Die zweite If-Anweisung zeigt die Seitenformat-Dialogbox an. Wenn der Anwender im Seitenformat-Dia- 
log die OK-Taste betatigt, liefert PageSetupDialog True zuriick und SetupString wird mit der 
Seitenformat-Eigenschaft belegt. Der Menu-Handler verwendet die Seitenformat-Eigenschaft, um die Einstellungen 
des Anwenders zu speichern. 


Verwalten des Drucken...-Meniipunkts 


Zum Drucken von Text mit Stilinformationen verwenden Sie ein Objekt des Typs StyledTextPrinter. Dieses verfiigt tiber 
die DrawBlock-Eigenschaft, mit deren Hilfe der Text zu Papier gebracht wird. 


Der Drucken...-Menu-Handler wird folgendermafsen implementiert: 


1. Rufen Sie den Mentipunkt Bearbeiten/Neuer Menu-Handler auf und wahlen Sie aus dem Popup-Menii den Eintrag 
AblageDrucken. 


2. Geben Sie folgenden Programmcode fiir den Menu-Handler ein: 

Dim stp as StyledTextPrinter 

Dim g as Graphics 

Dim ps as PrinterSetup 

Dim Seitenbreite as Integer 

Dim Seitenldénge as Integer 

ps=New PrinterSetup 

If Seitenformat<>"" then //Seitenformat enthalt Werte 
ps.SetupString=Seitenformat 
Seitenbreite=ps .width-36 
Seiten] dnge=ps.height-36 
//Drucken-Dialog mit den Werten aus Seitenformat 6ffnen 
g=openPrinterDialog(ps) 

else 
g=openPrinterDialog()//Dialog ohne Seitenformat-Angaben offnen 
Seitenbreite=72*7.5 //Defaultbreite und -hdhe 
Seiten] ange=72*9 

End if 

If g<>Nil then //Der Anwender hat den Drucken-Dialog nicht abgebrochen 
stp=TextFeld.StyledTextPrinter(g,Seitenbreite-48) 
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Do until stp.eof 
stp.drawBlock 36,36,Seitenldnge-48 
if not stp.eof then //gibt es noch zu druckenden Text? 
g.NextPage 
end if 
Loop 
end if 


Der Menu-Handler verwendet die StyledTextPrinter-Methode der EditField-Klasse, um ein StyledTextPrinter-Objekt 
(stp) zu erzeugen. Falls der Anwender im Seitenformat-Dialog Einstellungen vorgenommen hat, ist die Seitenfor- 
mat-Eigenschaft nicht Null und ihre Werte konnen zum Drucken verwendet werden. Die Eigenschaften Width und 
Height des PrinterSetup-Objekts sind die Hohe und Breite des gesamten bedruckbaren Bereichs, wie er in der Seiten- 
format-Dialogbox festgelegt ist. Normalerweise verwendet ein Textdokument mit Stilinformationen zusdtzliche Rander 
links, rechts, oben und unten. Daher wurden die Width- und Height-Eigenschaften entsprechend verkleinert. Sie k6n- 
nen nattirlich auch andere Werte fiir das Seitenformat wahlen. 


Wenn der Anwender den Seitenformat-Dialog nicht aufruft, werden die Vorgabewerte ftir HGhe und Breite des bedruck- 
baren Bereichs verwendet. 


Da das TextFeld mehr als eine Textseite beinhalten kann, miissen Sie das Drucken mehrerer Seiten unterstiitzen. Die 
boole’sche Eigenschaft EOF (end of file) eines StyledTextPrinter-Objekts ist so lange False, so lange noch Text zu dru- 
cken ist. Die Do Loop Schleife wird deshalb so lange ausgefiihrt, bis EOF True ist. Sie enthalt einen Aufruf der Draw- 
Block-Methode, welche einen Textblock auf die Seite druckt. 


stp.drawBlock 36,36, Seitenldnge-48 


Die ersten beiden Parameter legen den Abstand der linken oberen Ecke des Blocks von der linken oberen Ecke des im 
Seitenformat definierten bedruckbaren Bereichs fest. 


Als dritter Parameter wird die Hohe des Textblocks tibergeben. (Die Breite des Blocks wurde bereits der StyledTextPrin- 
ter-Methode als Parameter Seitenbreite tibergeben). 


Sobald Sie einen Textblock gedruckt haben, miissen Sie feststellen, ob weiterer Text gedruckt werden muss. Ist dies der 
Fall, miissen Sie die NextPage-Methode der Graphics-Klasse zum Erzeugen einer neuen Seite aufrufen. Dies wird 
durch die If-Anweisung innerhalb von Do loop gewahrleistet. 


Im Beispielcode wurden die an DrawBlock tibergebenen Parameter passend ftir eine 8,5x11 Zoll gro&e Seite gewahlt. 
Fiir andere Seitenformate sollten Sie die Werte von pageWidth, pageHeight und die Position der linken oberen Ecke 
des Druckbereichs anpassen. 


Testen der Druckfunktion 

1. Rufen Sie den Meniipunkt Debug/Programm starten auf und geben Sie Text in den Texteditor ein. 
2. Weisen Sie dem Text verschiedene Schriftarten, Schriftgré&en und Stile zu. 

3. Verwenden Sie die Mentipunkte Seitenformat... und Drucken..., um die Druckfunktion zu testen. 
4. Beenden Sie Ihr Programm, um in die Entwicklungsumgebung zuriickzukehren. 


Ruckblick 


In diesem Kapitel haben Sie Ihr Programm um die Funktion erweitert, Texte mit Stilinformationen zu drucken. 


10. Kommunikation zwischen Fenstern 


In diesem Kapitel erfahren Sie, wie REALbasic-Objekte miteinander kommunizieren. Sie werden lernen, wie man: 


© eine Finden- und Ersetzen-Dialogbox realisiert, 
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© Code schreibt, der die Kommunikation zwischen dem Finden- und Ersetzen-Dialog und Texteditor erlaubt. 


Die Finden-Funktion, die Sie einbauen werden, ist eine einfache Routine, die ab Cursorposition bis zum Ende des Textes 
sucht. Sie wird keine Méglichkeit bieten, wieder an den Textanfang zurtickzugehen und die Suche von dort aus erneut 
zu starten. Sie kénnen diese Funktionen allerdings spater selbst einbauen. Die hier realisierte Finden-Funktion unter- 
scheidet nicht zwischen Grofs- und Kleinschreibung. 


Los geht's 


Offnen Sie die REALbasic-Projektdatei, die Sie am Ende des letzten Kapitels gespeichert haben (TextEditor-Kapitel9). 
Falls notig, verwenden Sie die mitgelieferte Datei TextEditor-Kapitel9, die Sie im Ordner Tutorial Projekt finden. 


Implementieren einer Finden-Dialogbox 


Sie sind bereits damit vertraut, wie Mentipunkte hinzugefiigt, aktiviert und ihre Menu-Handler implementiert werden. In 
diesem Kapitel ist neu, dass die Dialogbox, die durch einen Meniieintrag aufgerufen und angezeigt wird, mit einem 
anderen Fenster der Applikation kommunizieren muss. 


Sie beginnen damit, einen Finden-Meniipunkt in das Bearbeiten-Menii einzubauen. 


Erzeugen des Menieintrags 
1. Fiihren Sie einen Doppelklick auf Meniileiste1 im Projekt-Fenster aus. 
2. Selektieren Sie im Meniti-Editor das Bearbeiten-Menii. 


3. Selektieren Sie den leeren Mentieintrag am Ende des Bearbeiten-Meniis und geben Sie Finden... als seine 
Text-Eigenschaft ein. Als Name-Eigenschaft tragen Sie BearbeitenFinden (ohne die drei Punkte am Schluss!) ein. 

4. Geben Sie F als CommandKey-Eigenschaft an. Deaktivieren Sie die AutoEnable-Eigenschaft. 

5. Selektieren Sie den leeren Meniieintrag am Ende des Bearbeiten-Mentis und geben Ersetzen... als seine 
Text-Eigenschaft ein. Als Name-Eigenschaft tragen Sie BearbeitenErsetzen (ohne die drei Punkte am Schluss!) ein. 

6. Geben Sie H als CommandKey-Eigenschaft an. Deaktivieren Sie die AutoEnable-Eigenschaft. 

7. Selektieren Sie den leeren Mentieintrag am Ende des Edit-Meniis und geben Sie als Text-Eigenschaft ein Minus ,-“ an. 
Damit erzeugen Sie eine Trennlinie. 

8. Draggen Sie die Trennlinie zwischen die Meniieintrage Loschen und Alles auswahlen. 

9. Draggen Sie den Mentipunkt Alles auswahlen an das untere Ende, fiigen Sie einen weiteren Separator ein und plat- 
zieren Sie diesen zwischen Ersetzen und Alles auswahlen. 
Das Bearbeiten-Menii sollte nun folgendermafsen aussehen: 

e008 Meniileiste1 


= @ Ablage Bearbeiten ce) 
Widerrufen 


Ausschneiden 
Kopieren 
Einfiigen 
Loschen 


Finden... 
Ersetzen.. 


Alles auswahlen 3A 


10. Schliefsen Sie den Menii-Editor und speichern Sie Thr Projekt unter TextEditor-Kapitel 10. 


54 Tutorial 


Aktivieren des Finden- und Ersetzen-Menieintrags 

Der Finden-Mentipunkt soll nur dann aktiv sein, wenn ein Textfenster ge6ffnet ist. Deshalb wird er im Code-Editor ftir 
TextFenster aktiviert. 

Um den Meniieintrag zu aktivieren, mtissen Sie folgendes tun: 

1. Offnen Sie den Code-Editor fiir TextFenster im Projekt-Fenster. 

2. Selektieren Sie im Browser den EnableMenultems Event-Handler. 


3. Fiigen Sie folgenden Code an das Ende der Methode an: 
BearbeitenFinden. Enable 
BearbeitenErsetzen.Enable 


Der Code-Editor sollte folgendermafsen aussehen: 
eee Code Editor (TextFenster) 


» Figenschaften Sub EnableMenultems() 
v # Events BearbeitenAllesauswaehlen.Enable 
'} Activate If TextWurdeGeandert Then 
=) CancelClose AblageSichern.Enable 
“S Close End if 
“S Deactivate | AblageSichernunter.Enable 
“S DropObject AblageSeitenformat.Enable 
> EnableMenultems AblageDrucken.Enable 


BearbeitenFinden.Enable 


os 4 BearbeitenErsetzen.Enabld 
MouseDown End Sub 


Y 
=] fe ip 


“S KeyDown 


4. SchliefSen Sie den Code-Editor und speichern Sie Thr Projekt. 


Erzeugen der Finden- und Ersetzen-Dialogbox 


Die nachste Aufgabe ist das Erzeugen der Dialogbox. Sie werden hierzu eine einzelne Dialogbox erzeugen, die fiir die 
Suchen- und fiir die Ersetzen-Funktion zustandig ist. Dazu werden Sie ein TabPanel-Steuerelement verwenden, das dem 
Anwender gestattet, eine der beiden Funktionen auszuwahlen, nachdem die Dialogbox ge6ffnet wurde. Die Dialogbox 
soll am Ende folgendermafen aussehen: 


ean Finden und Ersetzen ea Finden und Ersetzen 
{Finden | Ersetzen \ {Finden | Ersetzen | 
Suchen nach: Suchen nach: | 
( Abbrechen ° Finde “Abbrechen ) Finde 


Beginnen Sie damit, Ihrem Projekt ein neues Fenster hinzuftigen. 

1. Holen Sie das Projekt-Fenster nach oben. Wahlen Sie Ablage/Neues Fenster (Windows: Datei/Neues Fenster). 
REALbasic erzeugt im Projekt ein neues Fenster namens Fenster1. 

Andern Sie den Namen des Fensters im Eigenschaften-Fenster auf FindenFenster. 

Andern Sie die Title-Eigenschaft auf Finden und Ersetzen. 

Andern Sie Breite und Hohe: Width: 340, Height: 140. 


Deselektieren Sie die Eigenschaften Growlcon und ZoomIcon. 


Diese Eigenschaften werden deselektiert, weil FindenFenster eine Dialogbox fester Grofe sein soll. 


Mit folgenden Schritten fiigen Sie dem leeren Fenster die Steuerelemente hinzu: 


1. Draggen Sie aus der Steuerelemente-Palette ein TabPanel-Steuerelement ===" in das FindenFenster. 
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Setzen Sie die 
Klicken Sie au 
Klicken Sie au 


Klicken Sie au 


OO Se Oye Re SS 


Klicken Sie au 


Als nachstes werd 


Eigenschaften Left, Top, Width und Height des TabPanels auf die Werte 8, 6, 321 und 124. 
f den Karteireiter mit den drei Punkten, um den Panel-Editor aufzurufen. 
fTab 0 und dann auf den Bearbeiten-Knopf. 


Andern Sie seinen Namen in Finden und klicken Sie auf OK. 


fTab 1 und dann auf den Bearbeiten-Knopf. 


Andern Sie den Namen in Ersetzen und klicken Sie auf OK. 


f OK, um den Panel-Editor zu beenden. 


en die benotigten Steuerelemente auf der Finden-Karteikarte platziert. 


1. Klicken Sie auf den Finden-Karteireiter. Draggen Sie ein StaticText-Steuerelement £4 Q in die linke obere Ecke der 


Karteikarte. D: 
2. Setzen Sie die 


ieses Steuerelement nimmt die Beschriftung des Eingabefeldes auf. 
Eigenschaften Left, Top, Width und Height auf 21, 48, 84 und 16 und andern Sie die Text-Eigenschaft 


auf Suchen nach:. 


3, Draggen Sie aus der Steuerelemente-Palette ein EditField-Steuerelement | rechts neben das StaticText-Steu- 
erelement und weisen ihm folgende Eigenschaften zu: 
Eigenschaft Wert 
Name FindentText 
Left 112 
Top B 
Width 204 
Height 22 


4, Ziehen Sie einen PushButton (ox » aus der Steuerelemente-Palette in die rechte untere Ecke der Karteikarte. 


5. Selektieren Sie den PushButton und rufen Sie Bearbeiten/Duplizieren auf, um den zweiten Knopf zu erzeugen. 


Weisen Sie den PushButtons folgende Eigenschaften zu (der rechte ist der Finden-Knopf): 


Eigenschaft Abbrechen-Knopf Finden-Knopf 
Name AbbrechenKnopf FindenKnopf 
Left 140 243 

Top 101 101 

Width 85 70 

Caption Abbrechen Finden 
Default Nicht aktiv Aktiv 

Cancel Aktiv Nicht aktiv 
Enabled Aktiv Nicht aktiv 


Die Finden-Karteikarte sollte jetzt so aussehen: 


eee 


Finden und Ersetzen 


{Finden Ersetzen |... | 


Suchen nach: 


( Abbrechen ) 
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Als nachstes miissen Sie die Steuerelemente der Ersetzen-Karteikarte erzeugen. Die Ersetzen-Karteikarte entspricht der 
Finden-Karteikarte mit dem Unterschied, dass sie zusdtzlich ein Eingabefeld fiir den Ersatztext samt Feldbeschriftung 
enthalt. 
1. Klicken Sie auf den Ersetzen-Karteireiter des TabPanel-Steuerelements. 
Dies blendet die Steuerelemente des Finden-Panels aus und erlaubt Ihnen, einen neuen Satz von Steuerelementen 
zu platzieren, die nur angezeigt werden, wenn der Anwender auf den Ersetzen-Karteireiter klickt. 


2. Draggen Sie ein StaticText-Steuerelement £4 @Q in den linken oberen Bereich. Das Steuerelement wird als Beschrif- 
tung ftir den Finden-Eintrag im Ersetzen-Panel dienen. 

3. Setzen Sie die Eigenschaften Left, Top, Width und Height auf 21, 48, 84 und 16 und andern Sie die Text-Eigen- 
schaft auf Suchen nach:. 


4. Draggen Sie aus der Steuerelemente-Palette ein EditField-Steuerelement | rechts neben das StaticText-Steu- 


erelement und weisen ihm folgende Eigenschaften zu: 


Eigenschaft Wert 
Name SuchText 
Left 112 

Top 43 
Width 204 
Height 22 


5. Duplizieren Sie StaticText und EditField und verschieben Sie diese nach unten. 


6. Setzen Sie die Eigenschaften Left, Top, Width und Height des neuen StaticText-Steuerelements auf 21, 73, 84 und 
16 und andern Sie die Text-Eigenschaft in Ersetze durch:. 


7. Setzen Sie die Eigenschaften des EditField-Steuerelements auf folgende Werte: 


Eigenschaft Wert 
Name Ersetzelext 
Left 112 

Top 70 

Width 204 

Height 22 


8. Ziehen Sie als nachstes ein PushButton-Steuerelement aus der Steuerelementepalette in die rechte untere Ecke der 


Karteikarte. 


9. Duplizieren Sie den PushButton und ziehen Sie die Kopie links neben das Original. 
10. Weisen Sie den PushButtons folgende Eigenschaften zu (der rechte ist der Ersetzen-Knopf): 


Eigenschaft Abbrechen Ersetzen 
Name ErsetzenAbbrechen ErsetzenKnopf 
Left 140 243 

Top 101 101 

Width 85 70 

Caption Abbrechen Ersetzen 
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Eigenschaft Abbrechen Ersetzen 
Default Nicht aktiv Aktiv 
Cancel Aktiv Nicht aktiv 
Enabled Aktiv Nicht aktiv 


Die Ersetzen-Karteikarte sollte nun so aussehen: 


e008 Finden und Ersetzen 


Finden |»Ersetzens) ... | 


Suchen nach: 


Ersetze durch 


( Abbrechen ) 


Aktionen fir jedes Steuerelements festlegen 


Jetzt miissen Sie die Aktionen ftir jedes Steuerelement festlegen. 


1; 
2. 


Klicken Sie im Projekt-Fenster auf FindenFenster und 6ffnen Sie den Code-Editor mit alt-Tab. 
Expandieren Sie den Steuerelemente-Eintrag. 
Hier sehen Sie die Namen der Objekte, die Sie gerade in das FindenFenster eingebaut haben. 


Expandieren Sie FindenText und klicken Sie auf den TextChange-Event-Handler. Dieser wird ausgeftihrt, wenn der 
Anwender in der Finden-Dialogbox Text eingibt oder editiert. Geben Sie folgende Code-Zeilen ein: 
If len(Me.Text)>0 then //wenn der Anwender Text eingegeben hat 
FindenKnopf.Enabled=True 
else 
FindenKnopf.Enabled=False 
end if 
Der If-Befehl stellt fest, ob das FindenText-Feld Text enthalt (die Me-Funktion ist eine Referenz auf das Steuerele- 
ment, dem der Event-Handler gehort — in diesem Fall FindenText). Wenn das der Fall ist, wird der Finden-Knopf 


aktiviert. 


Expandieren Sie SuchText (der Finden-Eingabebereich im Ersetzen-Bereich) und klicken Sie auf den Text- 
Change-Event-Handler. Fiigen Sie folgenden Code in den Event-Handler ein: 


If len(Me.Text)>0 then 
Ersetzenknopf.Enabled=True 
else 
Ersetzenknopf.Enabled=False 
end if 


Dieser Code aktiviert den Ersetzen-Knopf auf der Ersetzen-Karteikarte. 

Expandieren Sie AbbrechenKnopf und dort Action. Geben Sie folgende Zeile ein: 

Close 

Damit wird das Fenster geschlossen, indem eine Methode der Window-Klasse aufgerufen wird. 

Expandieren Sie ErsetzenAbbrechen und fiigen Sie dort ebenfalls folgende Zeile in den Action-Event-Handler ein: 
Close 


Expandieren Sie FindenKnopf und klicken Sie dann auf Action. Geben Sie folgende Zeilen ein: 


TextFenster(Window(1)).Finden FindenText.Text,"" 
Close 


Diese Methode ruft eine Methode namens Finden auf, die die eigentliche Arbeit verrichtet. Sie tibernimmt als Para- 
meter den Text, den der Anwender auf der Finden-Karteikarte eingegeben hat. 
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Der zweite Parameter der Finden-Methode ist der Ersatztext, der fiir die Finden-Funktion nicht bendtigt wird und 
deshalb als leerer String tibergeben wird. 


Die Window-Funktion wird verwendet, um das TextFenster zu bestimmen, in dem gesucht werden soll. Der Aus- 
druck Window(1) verweist auf das zweite Fenster -Window/(0) ist der Finden und Ersetzen Dialog selbst — daher ist 
Window(1) das oberste Dokumentfenster. 


8. Expandieren Sie ErsetzenKnopf und klicken Sie auf den Action-Event-Handler. Fiigen Sie folgenden Code hinzu: 


TextFenster(Window(1)).Finden SuchText.Text,ErsetzeText. Text 
Close 


Dieser Code tibergibt den Inhalt von ErsetzeText als zweiten Parameter an die Finden-Methode. 


Finden-Methode fir TextFenster hinzufiigen 
1. Selektieren Sie TextFenster im Projekt-Fenster und 6ffnen Sie mit alt-Tab den Code-Editor. 
2. Wahlen Sie Bearbeiten/Neue Methode, um die Finden-Methode zu erzeugen. 


3. Geben Sie Finden als Methoden-Namen und Wert as String, Ersetzen as String als Parameter ein. Die Dialogbox 
sollte so aussehen: 


Methode: Finden @ 
Parameter: Wert as String, Ersetzen as String 
Riickgabetyp: 


Giiltigkeitsbereich: _ Offentlich (Uberall) 


& 
is) 
(Abbrechen ) GOK 


4. Klicken Sie auf OK, um den Code-Editor der Finden-Methode anzuzeigen. 


5. Geben Sie folgende Quelltextzeilen in den Code-Editor ein: 
Dim FoundAt as Integer 
FoundAt=inStr(TextFeld.SelStart, TextFeld.Text,Wert) 
If FoundAt>0 then //selektiere den Zieltext 

TextFeld.SelStart=FoundAt-1 
TextFeld.Sel Length=Len(Wert) 
If FindenFenster.tabpanell.value=1 then // Ersetze-Panel 
TextFeld.SelText=Ersetzen 
End if 
Else 
Beep 


MsgBox "Der Text "+chr(210)+Wert+chr(211)+" wurde nicht gefunden." 
End if 


Der Code-Editor sollte nun so aussehen: 
e088 Code Editor (TextFenster) 


if Higssschartan Sub Finden(Wert as String, Ersetzen as String) 

> 99 Events Dim FoundAt as Integer 

> [) Menu-Handler FoundAt=inStr(TextFeld.SelStart, TextFeld.Text,Wert) 

¥ B® Methoden If FoundAt>0 then //selektiere den Zieltext 
ateiSichern TextFeld.SelStart=FoundAt-1 
‘inden TextFeld.SelLength=Len(Wert) 
‘ontgréReMeniiEins_. If FindenFenster.tabpanell.value=1 then // Ersetze-Panel 
etzeSchriftMena TextFeld.SelText=Ersetzen 
> Ei Notizen aig 


Else 
> G Steuerelemente Beep 


MsgBox "Der Text "+chr(210)+Wert+chr(211)+" wurde nicht gefunden." 
End iff 
End Sub 


fF) =] ie > 
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Diese Methode ermittelt die Position des gesuchten Strings (Parameter Wert) mit Hilfe der InStr-Funktion. InStr 
erwartet drei Parameter: die Startposition, den Text, der durchsucht werden soll und den Text, nach dem gesucht 
wird. Verlduft die Suche erfolgreich, wird die Fundstelle mit Hilfe der SelStart- und SelLength-Eigenschaften von 
TextFeld im Fenster hervorgehoben. 


Der zweite If-Befehl tiberpriift, ob der Anwender die Ersetzen-Karteikarte der Dialogbox verwendet hat. (Die 
Value-Eigenschaft eines TabPanel-Steuerelements liefert die Nummer der Karteikarte zurtick, wobei die erste Kartei- 
karte die Nummer Null hat). In diesem Fall wird der gefundene Text (dieser entspricht der SelText-Eigenschaft) 
durch den Inhalt des Ersetzen-Parameters ersetzt. 


Jetzt fehlen noch die Menu-Handler fiir die Finden- und Ersetzen-Meniieintrige. Der jeweilige Menu-Handler sorgt 
daftir, dass die richtige Karteikarte der Dialogbox angezeigt wird. 


1. 
2. 
3. 


Testen der Finden- und Ersetzen-Funktionen 


Rufen Sie bei aktivem Code-Editor von TextFenster den Mentipunkt Bearbeiten/Neuer Menu-Handler auf. 
Wahlen Sie BearbeitenFinden aus dem Popup des Menu-Handler-Dialogs und klicken Sie auf OK. 


Geben Sie folgende Zeile in die Menu-Handler-Methode ein: 
FindenFenster. Show 


Show ist eine Methode der Window-Klasse. Diese Zeile stellt die Dialogbox dar. 


Rufen Sie erneut Bearbeiten/Neuer Menu-Handler auf, wahlen Sie BearbeitenErsetzen und OK. 


Fiigen Sie folgenden Code in den Menu-Handler des Ersetzen-Meniieintrags ein: 
FindenFenster. Show 
FindenFenster. TabPanell.Value=1 


Mit Show wird die Dialogbox angezeigt. Die zweite Zeile sorgt daftir, dass die zweite Karteikarte des TabPanel-Steu- 
erelements dargestellt wird (die erste Karteikarte hat die Nummer 0, die zweite die Nummer 1). 


Wahlen Sie Debug/Programm starten, geben Sie Text ein und testen Sie die Mentipunkte Finden und Ersetzen. 


Sie werden folgenden Schwachpunkt bemerken: Wenn Sie die Karteikarte wechseln, wird Text, den Sie ins Suchen 
nach-Feld eingegeben haben, nicht auf die andere Karteikarte tibernommen. Das ldsst sich leicht 4ndern: 


1. 


2. 


3. 


4, 


Kehren Sie in die Entwicklungsumgebung zurtick und expandieren Sie das TabPanel1-Objekt im Code-Editor von 
FindenFenster. 


Selektieren Sie den Change-Event-Handler. 
Dieser Event wird ausgeftihrt, wenn der Anwender auf einen Karteireiter klickt. 


Geben Sie folgenden Code ein: 


//Wenn das Finden-Feld nicht leer ist, wenn der Anwender 
//zwischen den Panels umschaltet, wird das andere 
//Panel mit dem Finden-Text aktualisiert. 
Select case TabPanell.Value 
Case 0 //Finden-Panel 
If SuchText.text <> "" then 
FindenText.text=SuchText. Text 
End if 
Case 1 //Ersetzen-Panel 
If FindenText.text <> "" then 
SuchText. text=FindenText. text 
End if 
End select 


Der Select Case-Befehl kopiert abhangig davon, welche Karteikarte gerade angezeigt wird, den Inhalt des ,Suchen 
nach‘-Feldes in das ,,Suchen nach‘-Feld der anderen Karteikarte. 


Speichern Sie Ihr Projekt und testen Sie Ihr Programm. 
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Ruckblick 


In diesem Kapitel haben Sie ein TabPanel-Objekt verwendet und erfahren, wie man Objekte erzeugt, die miteinander 
kommunizieren. 


11. Fehlersuche 


In diesem Kapitel werden Sie mit dem REALbasic-Debugger arbeitet. Sie werden lernen, wie man: 
e Syntax-Fehler findet und behebt, 

© den Debugger benutzt, um logische Fehler im Quelltext zu finden, 

@ lLaufzeitfehler behandelt. 


Los geht's 


Offnen Sie das Projekt TextEditor-Kapitel10. Falls notig, verwenden Sie die mitgelieferte Datei, die Sie im Ordner 
Tutorial Projekt finden. 


Benutzen des Debuggers 


Der REALbasic-Debugger unterstiitzt Sie bei der Fehlersuche und ist einfach zu benutzen. Im Grunde genommen haben 
Sie den Debugger bereits benutzt, ohne es zu wissen. 


Automatische Debugging-Features 
Ein Teil des REALbasic-Debuggers ist bereits dann aktiv, wahrend Sie Quelltextzeilen eintippen. Automatisches Einrti- 
cken und farbliches Hervorheben von Schliisselw6rtern machen die Arbeit im Code-Editor tibersichtlicher und helfen, 
Fehler zu vermeiden. 
Der Debugger wird auch dann aktiv, wenn Sie Debug/Programm starten aufrufen. Dann tiberpriift REALbasic Ihren 
gesamten Code auf Syntax-Fehler und stoppt, wenn es einen findet. 
Um die Syntax-Priifung in Aktion zu erleben, machen Sie einmal folgendes: 
1. Offnen Sie den Code-Editor fiir TextFenster und expandieren Sie den Eintrag Methoden. 
2. Klicken Sie die Fontgr6BeMeniEinstellen-Methode an, um deren Code anzuzeigen. 
3, Andern Sie die Zeile 
s=0 
in 
s=”0” 
Dadurch dndern Sie den Datentyp der Null von Zahl auf String. 
4. Rufen Sie den Meniipunkt Debug/Programm starten auf. Es erscheint die Fehlermeldung ,,Falscher Typ“. Die 
betroffene Programmzeile ist hervorgehoben: 


e008 TextFenster Quellcode 
> (@ Eigenschaften —— 
> 7) Events Function Fontgré&eMentEinstellen(FontGrdRe As Integer) As Integer 
> (@ Konstanten Dim s as Integer 
Select case FontGroke 
> [sy Menu-Handler aa 
v B Methoden s="0" 
=) DateiSichern | case 10 
Finden s=] 
FontgréReMeniiEit case 12 
= SetzeSchriftMena at, 
> © Notizen a one a 


s=3 
> (a Steuerelemente M > 


BE] + 
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Die Variable s wurde als Integer deklariert, deshalb konnen ihr nur Zahlen zugewiesen werden. 


Wenn Sie auf den Hilfe-Knopf rechts neben der Fehlermeldung klicken, wird die Online-Referenz gedffnet und der 
Eintrag zu diesem Fehler angezeigt. 


‘e080 Sprachreferenz 
«| |») [al Eeeenend 
“Alpha Fethemeny Falscher Typ Fehler 
Esgibtkeine Kl... | Tritt auf, wenn Sie versuchen, einen Parameter mit falschem Datentyp zu ubergeben oder 
Exception Obje... in einem Zuweisungsbefehl einen falschen Datentyp verwenden. Die zweite Zeile der 
Extends kann n.... Meldung sagt Ihnen, welchen Datentyp REALbasic erhalten hat und welchen es erwartete. 
Externe Funktio... Beispiele 
Exteme Funktio... _Es wurde versucht, einem String eine Integer-Variable zuzuweisen 
Falscher Typ 0! mn as Integer 
Far die Deklarat... wd — 
coro zl Sa 
Kann dieser Big. "as Boolean } 
Logische Opera... ndtigt einen Index | a 
Me kann nichti... 4 Die zweite Zeile der Meldung wird sein: ,Erwartete Boolean(), erhielt Boolean”. ’ 


Mit #if k6nnen ... | 


5. Korrigieren Sie den Fehler, indem Sie die Anftihrungszeichen wieder ldschen. 
6. Testen Sie das Programm erneut. 


Da keine weiteren Syntaxfehler auftreten, kann REALbasic Ihr Programm compilieren. 


Alle Fehlermeldungen anzeigen 


Sie konnen festlegen, dass alle wahrend eines Compiler-Laufs aufgetretenen Fehler auf einmal angezeigt werden. Stan- 
dardmiaifsig verhdlt sich REALbasic wie oben beschrieben: Der Compiler-Lauf wird beim ersten Fehler unterbrochen. Ob 
Thr Quelltext weitere Fehler enthalt, erfahren Sie erst beim nachsten Compiler-Lauf. 

Wenn Sie ein gré&eres Projekt bearbeiten ist es wahrscheinlich effizienter, wenn Sie die Option Alle Compiler-Fehler- 
meldungen zeigen aktivieren. Diese finden Sie im REALbasic Einstellungen-Dialog unter Erzeugen-Prozess. 
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= 1 Nach dem Erzeugen: 


w Erzeugte Applikationen auf Disk zeigen 


Online-Hilfe 


Malle Compiler-Fehlermeldungen zeigen 


Drucken 


(Abbrechen ) (OSD 


Ist diese Option aktiviert, werden alle Fehler in einem Fehlerfenster aufgelistet: 


‘eee Errors 
* Type mismatch error. Expected Integer, but got String in TextFenster.FontgréReMenUEinstellen, line 4: 
s="0" 


Indem Sie einen Doppelklick auf eine Fehlermeldung ausftihren, springen Sie zur Fehlerposition im Quelltext. 
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Suchen logischer Programmfehler 


Fehler, die wahrend des Programmablaufs auftreten, sind normalerweise logische Fehler. Um diese Fehler zu finden, 
miissen Sie REALbasic zunachst mitteilen, wo es suchen soll. 


Als erstes miissen Sie im Quelltext Ihres Programms in der Routine, in der Sie den Fehler vermuten, einen Breakpoint 
setzen. An einem Breakpoint wird das Programm gestoppt und der Debugger aufgerufen. Im Debugger kGnnen Sie 
dann die Werte der einzelnen Variablen, Eigenschaften und anderer Parameter tiberpriifen. Sie konnen nach unerwarte- 
ten, falschen oder undefinierten Werten suchen und entsprechende Korrekturen vornehmen. Sie konnen ebenso tiber- 
priifen, ob eine Methode auch wirklich dann aufgerufen wird, wenn Sie es erwarten. 


Breakpoints verdndern Ihren Code nicht und funktionieren nur in der REALbasic-Laufzeitumgebung, nicht in Stand- 
alone-Programmen. Die folgenden Ubungen zeigen, wie Sie Ihr Programm anhalten, die aktuellen Werte von Variablen 
iiberpriifen und eine Methode Zeile fiir Zeile abarbeiten lassen konnen: 


1. Offnen Sie den Code-Editor fiir TextFenster. 
2. Expandieren Sie im Browser die Methoden und selektieren Sie DateiSichern. 


Die DateiSichern-Methode wird angezeigt. Die Zeilen, in die Sie einen Breakpoint setzen k6nnen, sind am Zeilenan- 
fang mit einem Minus (,-) markiert. 


3. Klicken Sie in der Zeile, die die erste ,,if*-Anweisung enthalt, auf das Minus. Statt des Minuszeichens erscheint ein 
roter Punkt — das Symbol fiir einen Breakpoint: 


eee TextFenster Quellcode 
> G@ Eigenschaften 


be p Events Sub DateiSichern(Dateiname As String, SichernDialogZeigen As Boolean) 


> (@ Konstanten Dim f as Folderitem 
@ = |f Dokument=Nil or SichernDialogZeigen then 
all — laa iariaated f=GetSaveFolderitem( "text" Dateiname) 
¥ B® Methoden If f<>nil then //wenn der Anwender Sichern angeklickt hat 
=| DateiSichern Title=f.name 
inden Dokument=f 
FontgréSeMeniiEinste_ End if 
End if 
If Not SichernDialogZeigen then //Anwender wahite Sichern 
| If Dokument<>nil Then 
Dokument.SaveStyledEditField TextFeld 


etzeSchriftMenit 
> BB Notizen 
> Gg Steuerelemente 


TextWurdeGeandert=False 
End If 
Elseif SichernDialogZeigen then //Anwender wahite SichernAls oder Neues Dokument 
If Dokument <> Nil and f <> Nil then 
Dokument.SaveStyledEditField TextFeld 
TextWurdeGeandert=False 
End if 
End if 
End Sub 


BAe» 


Dieser Breakpoint wird REALbasic dazu veranlassen, den Programmablauf zu unterbrechen, sobald Sie ein Dokument 
in der Laufzeitumgebung speichern wollen. Wenn Sie versuchen, ein neues Dokument zu speichern, wird an Stelle 
der Dateiauswahlbox der Debugger erscheinen. 


4, Wahlen Sie Debug/Programm starten, um das Programm in der Laufzeitumgebung zu starten. 
5. Tippen Sie ein wenig Text ein und wahlen Sie dann Ablage/Sichern (Windows: Datei/Sichern) aus. 
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Thre Applikation stoppt am Breakpoint und zeigt den Debugger wie unten abgebildet. 


e088 Debugger 
Werkzeugleiste re? |] [| [| [| | [6] 
Stack TextFenster.DateiSichern Name Wert 
TextFenster.AblageSichern_Action Dateiname Namenlos e 
Nil 
: _ Wseit TextFenster 
Variablen {) warsrcnempraregzerger 
v 
> If Dokument=Nil or SichernDialogZeigen then 
f=GetSaveFolderitem("text" Dateiname) 
If f<>nil then //wenn der Anwender Sichern angeklickt hat 
Title=f.name 
ie Dokument=f 
Code-Editor —————_ End 
End if 


If Not SichernDialogZeigen then //Anwender wahlte Sichern 
If Dokument<>nil Then 
Dokument.SaveStyledEditField TextFeld 
TextWurdeGeandert=False - 
End If = 


Das Debugger-Fenster besteht aus drei Teilen: 

© Im Code-Editor wird die Methode angezeigt, die gerade ausgefiihrt wird. In der Abbildung wurde die Programmaus- 
fiihrung in der Zeile mit dem Breakpoint (zu erkennen an dem roten Kreis) gestoppt. Der griine Pfeil markiert die 
Zeile, die als nachstes ausgeftihrt wird. 

© Der Stack zeigt die Aufrufkette, die zum Aufruf der aktuellen Methode geftihrt hat. Dabei werden die Methoden in 
der Reihenfolge angezeigt, in der sie aufgerufen wurden (die aktuelle Methode steht oben). Mit Hilfe des Stacks k6n- 
nen Sie also tiberpriifen, ob eine Methode wie erwartet aufgerufen wurde. 

© Die Variablenliste enthilt alle lokalen Variablen der aktuellen Methode samt deren Werte (falls vorhanden). Den 
Datentyp kénnen Sie am Symbol vor dem Variablennamen erkennen. 


Name Wert 
(8) Dateiname Namentos [e) 
wr Nil 
WD self TextFenster 
(@H sichernDialogZeigen () 


Bei der Variablen SichernDialogZeigen handelt es sich um den Parameter, der an die Methode tibergeben wurde. Diese 
Variable ist vom Typ Boolean und enthalt derzeit den Wert False, was durch eine nicht aktive Checkbox dargestellt wird. 
Der Wert des String-Parameters ist ,Namenlos“. 

Objekte, die in der Methode definiert wurden und die bereits einen Wert haben, erscheinen blau unterstrichen als 
Hyperlinks. Im Beispiel ist f ein Folderltem, dem noch kein Wert zugewiesen wurde. 

Die Variable self ist eine Referenz auf das Fenster selbst und vom Typ TextFenster. Diese Variable konnen Sie in einem 
Object-Viewer 6ffnen, indem Sie auf den Hyperlink ,TextFenster“ klicken. Der Object-Viewer enthilt eine Liste aller 
Eigenschaften des Objekts. Je nach Objekttyp gibt es verschiedene Object-Viewer. 


ece8 TextFenster 
Name Wert 
(4 BackColor @#FFFFFF (255,255,255) 
WG Backdrop aNil 
BalloonHelp 4 e 
(BD CloseBox aTrue 
(I Composite QO 
3 ControlCount alo 
© Dockitem a@Dockitem 
W Dokument Nil 
FloaterProcess e 
GG) Frame ao . 
@B FullScreen 4False = 


5 Graphics Graphics ’ 
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Die Eigenschaften eines Objekts werden im Object-Viewer wie Variablen im Variablenfenster dargestellt. Der Wert einer 
Eigenschaft, die wiederum ein Objekt ist, verbirgt sich hinter einem Hyperlink auf einen weiteren Object-Viewer. In der 
Abbildung wird der Wert der Graphics-Eigenschaft als Hyperlink auf ihren Object-Viewer dargestellt. Es konnen beliebig 
viele Object-Viewer gleichzeitig gedffnet sein. 


Ein Object-Viewer ftir ein Fenster enthalt zwei Karteikarten. Die Karteikarte ,,Inhalt“ listet alle Steuerelemente des Fens- 
ters auf. Da es sich bei diesen wiederum um Objekte handelt, werden sie als Hyperlinks dargestellt: 
e008 TextFenster 


! Eigenschaften 


TextFeld 
StaticTextl 
GroesseMenue 
KnopfFett 
Knopfkursiv 


KnopfUnterstrichen 
StaticText2 
KnopfFarbe 
StaticText3 
SchriftMenue 


Variablenliste und Object-Viewer sind interaktiv und werden in Echtzeit aktualisiert, wahrend Sie Ihr Programm im 
Debugger schrittweise abarbeiten. Damit konnen Sie verfolgen, ob ein Problem durch einen bestimmten Wert (oder 
einen fehlenden Wert) verursacht wird. 


Die Werkzeugleiste des Debuggers enthilt fiinf Knopfe, die einen direkten Zugriff auf Funktionen des Debug-Meniis 
gestatten. Mit den Knopfen kGnnen Sie die Ausfiihrung Ihres Programms steuern. Es ist mglich, den Programmcode 
Zeile fiir Zeile auszuftihren. 


Programm fortsetzen 1% Funktion verlassen 


Programm abbrechen Nachste Zeile In Funktion springen 


Das Debug-Menii enthilt die gleichen Funktionen wie die Werkzeugleiste des Debuggers: 


«Programm fortsetzen €R 
% Programm abbrechen &#K 


®% Nachste Zeile 38) 
@ InFunktion springen  [ 


Funktion verlassen ,  9Y 


® Breakpoint ldschen eB 
& Alle Breakpoints léschen 
v $! Break bei Exceptions 


© Programm fortsetzen (in der IDE: Programm starten): Setzt die Ausfiihrung des Codes bis zum ndchsten Break- 
point fort. Mit diesem Befehl verlassen Sie das Debugger-Fenster. 

© Programm abbrechen: Bricht die Ausfiihrung des Programmcodes ab und bringt Sie zuriick zur REALbasic 
Entwicklungsumgebung. 

© Nachste Zeile: Fiihrt die aktuelle — mit einem griinen Pfeil markierte — Programmzeile aus. Springt zur nachsten 
Zeile. Wenn die aktuelle Zeile eine Methode beinhaltet, fiihrt der Debugger diese Methode auf einmal aus, arbeitet 
sie also nicht zeilenweise ab. 

© In Funktion springen: Fiihrt die aktuelle Zeile aus und springt auf die nachste. Falls die aktuelle Zeile einen Metho- 
denaufruf enthilt, zeigt der Debugger deren Code an und erlaubt es, diesen ebenfalls zeilenweise abzuarbeiten. 
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e Funktion verlassen: Die aktuelle Methode wird bis zum Ende ausgefiihrt, ohne dass jede Zeile einzeln bestitigt 
werden muss. Das ist besonders dann sehr praktisch, wenn Sie vorher mit dem Befehl In Funktion springen in die 
Methode gesprungen sind und diese nun wieder verlassen wollen. 


Im Variablen-Fenster sehen Sie, dass die Variable f undefiniert ist. So sollte es auch sein, so lange Sie das Dokument 
noch nicht gespeichert haben. Die Variable f wird definiert, wenn Sie das Dokument abspeichern. 


Im Debugger kénnen Sie Zeile fiir Zeile abarbeiten und den Inhalt des Variablen-Fensters beobachten. Sie erreichen 
dies durch die Knopfe Nachste Zeile oder In Funktion springen (bzw. deren Menii-Pendants). 


6. Klicken Sie in der Werkzeugleiste so oft auf den Knopf |*], bis der Sichern-Dialog erscheint. Mit jedem Klick wird 


eine Programmzeile abgearbeitet. 


7. Speichern Sie das Dokument unter einem beliebigen Namen und betrachten Sie dann die Variablenliste. 


Der Wert der Variablen f hat sich von Nil auf Folderltem geandert, da er nun definiert ist. Klicken Sie auf den 
Folderltem-Hyperlink, um f im Object-Viewer anzuzeigen: 


AbsolutePath 
(2B Alias 

GJ Count 

@3 CreationDate 
U5 DesktopFolder 
(5) Directory 

@H DisplayName 
(EI Exists 

(B) ExtensionVisible 
(B IsReadable 

(5) IsWriteable 
GG Last€rrorCode 
GD Length 

(BI Locked 

(5 MacCreator 
GO MacDiriD 

(8D MacType 


Name 


f 


Wert 
@ Macintosh HD:Users:thomas:Desktop:Mein Text Og 


aFalse 
ao 

a 

a 
afalse 
Mein Text 
aFalse 
aTrue 
aTrue 
aTrue 
al0l 
aod 
4False 
a7” 
488143 
a7” 


| 
| 
| 
| 
fe)| | 
] 


OL 
ey 


Hier sehen Sie u.a. den absoluten Pfadnamen des Dokuments und den Dateinamen, den Sie vergeben haben. 


8. Klicken Sie in der Variablenliste auf den Hyperlink ‘TextFenster, um dessen Object-Viewer zu 6ffnen. Scrollen Sie nach 
unten, bis Sie die Title-Eigenschaft im Blick haben. 


Klicken Sie auf den Knopf |*!. Sobald die Quelltextzeile Title=f.name ausgefiihrt wurde, andert sich die 


Title-Eigenschaft auf den von Ihnen eingegebenen Dateinamen: 


e008 TextFenster 
Name Wert 

(EH) MenuBarVisible aTrue 

GQ MinHeight a64 

GO Minwidth a64 

WG MouseCursor anil 

Gd Mousex a719 

GO Mousey a3l4 

GG Placement ao 

(8H Seitenformat 

(5) TextWurdeGeandert v 

Oz Title  Namenlos 

GO Top aso 

(@B visible aTrue 

GD width a669 

GD WinHwND a0 


eee TextFenster 
Inhalt | 
Name Wert 

(@B MenuBarVisible aTrue 

GG MinHeight a64 

D Minwidth a64 

5 MouseCursor anil 

(5 Mousex 0389 

(J Mousey 0237 


GJ Placement ao 
(8G Seitenformat e 


e 
' (BD) TextWurdeGeandert M | 
' —_ Oz Title ': Mein Text @ |] 
GS Top aso 
= @D visible = 


aTrue 
GD width a669 cd 
G3 winHwND a0 ’ 


9. Klicken Sie erneut auf den Knopf |*/, um die Zeile Dokument=f auszuftihren. 


Dabei werden Sie feststellen, dass sich die Dokument-Eigenschaft von TextFenster von Nil auf Folderltem andert. 


10. Klicken Sie auf den Knopf /|, um das Programm fortzusetzen. 


11. Beenden Sie Ihr Programm und kehren Sie zur Entwicklungsumgebung zuriick. 
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Laufzeitfehler abfangen 


Manche Fehler treten erst auf, wenn eine Anweisung unter bestimmten Bedingungen ausgeftihrt wird. Diese Fehler wer- 
den Laufzeitfehbler genannt und k6nnen nicht bei der Syntaxtiberpriifung gefunden werden. Wenn Sie Laufzeitfehler 
nicht abfangen, stiirzt die Stand-Alone-Version Ihrer Applikation ab, sobald die fehlerhafte Anweisung ausgefiihrt wird. 


Das Vorhandensein eines moglichen Laufzeitfehlers hindert REALbasic nicht daran, die Applikation erfolgreich zu compi- 

lieren. Die Applikation lauft so lange ohne Probleme, bis der fehlerhafte Code ausgeftihrt wird. Wenn sich der Fehler z.B. 

in einer If-Abfrage befindet und die Bedingung niemals True wird, lduft die Applikation ganz normal. 

Auf Laufzeitfehler konnen Sie mit der RunTimeException-Klasse reagieren. 

Um zu Testzwecken einen Laufzeitfehler zu erzeugen, k6nnen Sie folgendes tun: 

1. Stellen Sie sicher, dass im Debug-Meniti der Mentipunkt Break bei Exceptions mit einem Hakchen versehen ist. 

2. Expandieren Sie im Code-Editor den Steuerelemente-Eintrag von TextFenster und 6ffnen Sie den Schrift- 
Menue-Event-Handler. 


3. Selektieren Sie das Open-Event. Sie sehen folgenden Code: 


Dim i, nFonts as Integer 
nFonts=FontCount-1 
For 1=0 to nFonts 

me.AddRow Font(i) 
Next 
me.Caption=TextFeld.SelTextFont 


4, Andern Sie die Definition von nFonts=FontCount-1 auf nFonts=FontCount. 
5. Wahlen Sie Debug/Programm starten. 
Die Ausfiihrung stoppt und Sie erhalten folgende Fehlermeldung: 


ee8 Debugger 
2) *)[8)(2] “(6 
TextFenster.SchriftMenue_Open Name Wert 
Goi 231 
me BevelButton 
Gd nFonts 231 
self TextFenster 
i pa 
Sub Open() 


Dim i, nFonts as Integer 
nFonts=FontCount 
For i=0 to nFonts 
| me.AddRow Font(i) 
| OutOfBoundsException — (Hilfe) 
Caption=TextFeld: ‘extFont 
End Sub 


Der Fehler tritt auf, sobald i in der For-Schleife den Wert FontCount erreicht hat. Da die Mentieintrage aber mit 0 
beginnend durchnummeriert sind, versucht dieser Code, einen Mentieintrag ftir eine nicht vorhandene Schrift zu 
erzeugen. Der Wert liegt also auSerhalb der Indexgrenzen. Dies ist zwar kein Syntaxfehler, fiihrt aber zu einem Lauf- 
zeitfehler. 

Wenn ein Laufzeitfehler in einer Stand-Alone-Applikation auftritt, kann REALbasic natiirlich nicht die problematische 
Quelltextzeile anzeigen, in der der Fehler auftrat. Statt dessen erscheint eine Fehlermeldung: 


An exception of class OutOfBoundsException was 
not handled. 
_ The application must shut down. 


Mit Klick auf OK wird das Programm beendet. 
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Es gibt einen Weg, wie man Laufzeitfehler eleganter behandeln kann. Mit einem Exception Block kdnnen Sie Lauf- 
zeitfehler abfangen, wenn diese auftreten. Mehr zu diesem Thema finden Sie im Entwicklerhandbuch. 


12. Erzeugen eines Stand-Alone-Programms 


In diesem Kapitel werden Sie erfahren, wie Sie aus Ihrem Projekt eine Stand-Alone-Applikation ftir Mac OS, Windows 
oder Linux erzeugen. 


REALbasic Professional enthalt einen Cross-Compiler, der Stand-alone-Applikationen fiir alle drei Plattformen erzeugen 
kann. REALbasic Standard erzeugt Stand-Alone-Applikationen fiir die Plattform, auf der Sie es einsetzen und 
Demo-Applikationen ftir die anderen Plattformen. Diese Demoversionen beenden sich nach 5 Minuten selbst. 


Los geht's 


Starten Sie REALbasic und 6ffnen Sie das Projekt TextEditor-Kapitel10. Falls ndtig, verwenden Sie die mitgelieferte Pro- 
jektdatei aus dem Ordner Tutorial Projekt. 


Die Dialogbox ,,Compiler-Einstellungen” 


Wenn Sie hr Projekt ausgetestet haben und alles wie erwartet funktioniert, wollen Sie es bestimmt in ein eigenstandig 
lauffihiges Programm verwandeln. Als Stand-alone-Programm funktioniert Ihr Programm unabhangig von der REAL- 
basic-Entwicklungsumgebung wie jedes andere Mac OS-, Windows- oder Linux-Programm. 


Das Ablage-Menti (Windows: Datei-Meni) enthalt zwei Eintrage, die Sie zum Erzeugen von Stand-alone-Applikationen 
benotigen: Compiler-Einstellungen und Applikation erzeugen. Der Mentipunkt Compiler-Einstellungen zeigt eine 
Dialogbox an, in der Sie die Parameter ftir das Erzeugen der Applikation festlegen. Der Mentipunkt Applikation erzeu- 
gen erzeugt schlieflich die Stand-alone-Applikation und verwendet hierzu die Parameter, die Sie im Dialog Compi- 
ler-Einstellungen vorgegeben haben. 
Aus diesem Grund 6ffnen Sie normalerweise zuerst den Dialog Compiler-Einstellungen und erzeugen danach durch 
Applikation erzeugen Ihre Applikation. 
So erzeugen Sie aus einem Projekt ein Stand-alone-Programm: 
1. Wahlen Sie Ablage/Compiler-Einstellungen... bzw. Datei/Compiler-Einstellungen unter Windows. 

Einstellungen fur Applikation erzeugen 


Erzeuge fir: wv Mac OS X 
(Mac OS 8-9 (Classic) 
Windows 98/NT/2000/XP 


 Linux/x86 ¥ Versions-Information 
Mac OS Einstellungen 
Versions-Information <4 Windows-Einstellungen 
—— Linux/x86 Settings 
Version: fi }. 0.0 Compiler-Einstellungen 


Release: Entwicklungsstadium ins) 


Non-release: 0 


Kurze Version. 


Lange Version: [ 


Zusatzinfo: 


Region: Vereinigte Staaten i) 
Sprache: Standard (System) iz 


(Icons...) ( Abbrechen _) or— 
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Im oberen Bereich der Dialogbox wahlen Sie die Zielplattform, ftir die Sie Ihr Projekt compilieren wollen. Sie haben 
die Wahl zwischen Mac OS X, Mac OS 8/9, Windows 98/ME/NT/2000/XP und Linux fiir x86-Computer mit installiertem 
GTK-+ in Version 2 oder héher. Wenn Sie fiir mehrere Plattformen gleichzeitig compilieren wollen, setzen Sie einfach 
die entsprechenden Hakchen. 


2. Als Vorgabe ist die Platform ausgewahlt, auf der Sie arbeiten. Wenn Ihnen auch andere Betriebssysteme zum Testen 
zur Verfiigung stehen, selektieren Sie diese zusatzlich. 


3. Wenn Sie unter Mac OS arbeiten, wahlen Sie Mac OS Einstellungen aus dem Popup-Menii: 


Einstellungen fiir Applikation erzeugen 


Erzeuge fiir: vw Mac OS X 
(Mac OS 8-9 (Classic) 
Windows 98/NT/2000/XP 


C Linux/x86 


Mac OS Einstellungen i) 


Mac OS X-Name: Mein Programm 


Mac OS 8-9 Name: Mein Programm (Classic) 
Creator Code: mm | ( Registrieren ) 
Speicher: 
Bevorzugt: 4096 k 
Minimum: 2048 k 


Kompatibilitat: O Mac OS X only (Mach-O) 
@ Mac OS 8-9 and X (PEF) 


~Abbrechen _) cor 


( Icons... ) 


Geben Sie — je nachdem, welches Betriebssystem Sie verwenden, entweder als Mac OS X-Name oder als 
Mac OS 8-9-Name TextEditor ein. 


4, Wenn Sie unter Windows arbeiten, wahlen Sie Windows-Einstellungen aus dem Popup-Menii: 


Einstellungen fiir Applikation erzeugen 


Erzeuge fur: Mac OS X 


Mac OS 8-9 (Classic) 


‘Windows 98/NT /2000/xP 


Linux/86 


>-Einstellungen 


Programm-Name: |Texteditor.exe 


Multiple Document Interface 


Fenstertitel: 


Geben Sie TextEditor.exe unter Programm-Name ein. 


5. Wenn Sie fiir Linux compilieren, wahlen Sie Linux/x86-Einstellungen aus dem Popup-Menii und tragen als Pro- 
gramm-Name Texteditor ein. 


6. Klicken Sie auf OK, um die Einstellungen zu tibernehmen und den Dialog zu schliefen. 
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7. Rufen Sie danach den Mentipunkt Ablage/Applikation erzeugen (Windows: Datei/Applikation erzeugen) auf. 
REALbasic erzeugt fiir alle im Compiler-Einstellungen-Dialog gewahlten Plattformen Stand-alone-Programme, legt 
diese im Projektordner ab und 6ffnet diesen Ordner auf dem Schreibtisch. 

Sie konnen nun REALbasic beenden, einen Doppelklick auf das TextEditor-Symbol ausfiihren und nach Herzenslust 
Text erfassen. 

Wenn Sie fiir weitere Plattformen Stand-alone-Programme erzeugt haben, kGnnen Sie diese nun ebenfalls unter die- 
sen Plattformen testen. 
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Willkommen bei REALbasic 


Mit REALbasic konnen einfache und komplexe Programme sehr schnell entwickelt werden. Einsteiger werden feststel- 
en, dass REALbasic einfach zu erlernen ist. Erfahrene Entwickler werden zu schatzen wissen, wie schnell man mit REAL- 
basic das gewtinschte Ziel erreicht. 


Die grafische Benutzerschnittstelle, tiber die Ihr Programm mit dem Benutzer kommuniziert, nennt man Graphical User 
Interface oder auch GUI. Die Benutzerschnittstelle wird in REALbasic mit dem Graphical User Interface Builder zusam- 
mengesetzt. Wenn Sie wissen, wie man mit der Maus per Drag & Drop Elemente verschiebt, dann sind Sie in der Lage, 
mit dem GUI-Builder eine Benutzerschnittstelle aufzubauen. REALbasic bietet eine grofe Auswahl fertiger Steuerele- 
mente und gestattet dem Anwender dariiber hinaus, eigene Steuerelemente zu entwerfen. 


Die Entwicklungsumgebung wird auch als Integrated Development Environment (kurz IDE) bezeichnet, da sie alle Kom- 
onenten zusammenfasst, die im Laufe der Entwicklung bendtigt werden. 


Die in REALbasic verwendete Programmiersprache ist eine objektorientierte Version von BASIC. BASIC steht fiir Begin- 
ners All-Purpose Symbolic Instruction Code (frei tibersetzt: universelle Programmiersprache fiir Anfanger). Urspriinglich 
wurde BASIC ftir Lehrzwecke entwickelt. Daher ist die Syntax von BASIC auch weniger kompliziert als die der meisten 
anderen Programmiersprachen. REALbasic kennt die meisten Befehle, die es auch in BASIC gibt. Allerdings horen damit 
die Ahnlichkeiten zwischen BASIC und REALbasic auch schon auf. 


Die meisten BASIC-Dialekte werden interpretiert. Das bedeutet, dass in der Entwicklungsumgebung ein Ubersetzer 
Interpreter) eingebaut ist, der st’andig damit beschaftigt ist, jeden BASIC-Befehl in die tatsachliche Sprache des Prozes- 
sors (Maschinencode) zu tibersetzen. REALbasic hat keinen Interpreter, sondern verwendet einen Compiler, der den 
BASIC-Code voriibersetzt, so dass bei der Ausfiihrung des Programms der Hemmschuh der stindigen Ubersetzung ent- 
fallt. Tatsachlich hat REALbasic sogar einen dynamischen Recompiler. Bei jedem Start des Projekts werden also immer 
nur die gednderten Teile compiliert und nicht das gesamte Projekt, was die Geschwindigkeit erheblich steigert. 


Die in REALbasic verwendete BASIC-Variante ist objektorientiert. Sie sttitzt sich auf eine moderne Struktur, wie sie auch 
bei C-+ + oder Java zum Einsatz kommt. Das objektorientierte Modell teilt ein Programm in einzelne Objekte auf, deren 
Verhalten man definiert, so wie man es auch ftir Gegenstande in der wirklichen Welt tun konnte. Dies erleichtert den 
Uberblick und die Fehlersuche. Dabei ist REALbasic in vielerlei Hinsicht erheblich konsequenter als beispielsweise 
C++. Und auch einfacher zu erlernen. 


Da REALbasic es Ihnen erspart, die Programmierung der Benutzerschnittstelle des Betriebssystems zu erlernen, geht die 
Entwicklung sehr viel schneller als mit anderen Programmiersprachen von der Hand. Das Application Programming 
Interface (API) des Mac OS umfasst viele tausend Kommandos (Toolbox-Funktionen), die Sie nicht kennen miissen, 
wenn Sie mit REALbasic programmieren. 
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REALbasic installieren 


Ftir REALbasic auf dem Macintosh bendtigen Sie folgende Systemvoraussetzungen: 


Einen Macintosh mit PowerPC-Prozessor. 

Mac OS Classic 8.5-9.2.x. Mac OS 8.5 ist die empfohlene Minimalvoraussetzung fiir Mac OS Classic. 

Falls Sie Mac OS X verwenden, ist Version 10.1 die empfohlene Minimalvoraussetzung. 

Fiir Mac OS 8-9 bendtigen Sie mindestens 10 MB verftigbaren Speicher und der virtuelle Speicher sollte aktiviert sein. 
Weisen Sie dem Programm 2 MB mehr zu, wenn virtueller Speicher ausgeschaltet ist. Mac OS X verwaltet den Spei- 
cher dynamisch. 

© Mindestens 20 MB Speicher sollte auf der Festplatte fiir die Installation von REALbasic frei sein. 

Kopieren Sie das REALbasic-Programm, die Dokumentation und die Beispiele von der CD auf die Festplatte. 


Fiir die Installation unter Windows bendtigen Sie folgende Systemvoraussetzungen: 


@ Einen PC mit mindestens 200 MHz. 
© Windows 98, NT, 2000 oder XP. 


Verwenden Sie den Windows-Installer von der REALbasic-CD, um die Windows-Version zu installieren. 


Womit fangt man an? 


Wenn Sie gleich mit dem Programmieren beginnen wollen, sollten Sie sich den REALbasic QuickStart und das Tutorial 
ansehen. Dort finden Sie einen Uberblick tiber das System und die Programmiersprache. Lesen Sie dann dieses Benut- 
zerhandbuch. Hier finden Sie detaillierte Erlauterungen zur Sprache und den anderen Komponenten, die es in REAL- 
basic gibt. Wenn Sie Informationen zu einem bestimmten Kommando oder Steuerelement suchen, dann schlagen Sie in 
der Sprachreferenz nach. 


Aufbau der Dokumentation 


Mentipunkte 


Meniipunkte werden wie folgt beschrieben: Datei/Beenden (38-Q) bedeutet, dass der Mentipunkt Beenden im Menii 
Datei gewahlt werden soll. 


Tastatur-Shortcuts 


Die allermeisten Mentipunkte besitzen auch einen Tastaturbefehl. Auf dem Macintosh ist es die Befehlstaste (98), die am 
haufigsten zur Eingabe von Tastaturbefehlen eingesetzt wird. Auswahl (alt)- und Shift-Taste kommen ebenfalls vor. Unter 
Windows werden die Strg-Taste und manchmal auch die Alt- und Shift-Tasten benutzt. In der folgenden Anleitung wird 
immer zuerst der Macintosh-, dann der Windows-Tastaturbefehl angegeben. So bedeutet ,38-Q oder Strg-Q* Befehls- 
taste-Q auf dem Macintosh und Strg-Q unter Windows. 


Bildschirmfotos 


REALbasic ist eine echte Cross-Plattform-Anwendung. Das Programm Iduft unter Mac OS Classic (ab Version 8.5), 
Mac OS X und Windows. Alle mit REALbasic erzeugten Anwendungen laufen sowohl auf beiden Macintosh Betriebssyste- 
men als auch auf Windows-Betriebssystemen, von Windows 98 bis Windows XP Professional. Aufserdem werden diverse 
Linux-Distributionen fiir die x86-Plattform unterstiitzt. Die Bildschirmfotos in diesem Handbuch sind eine Mischung aus 
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Mac OS Classic, Mac OS X, Windows XP und Linux (GTK 2.x). Wo es notwendig ist, werden die Fenster und Steuerele- 
mente von fertigen Applikationen fiir alle vier Plattformen gezeigt. 


Code-Beispiele 


Code-Beispiele werden immer wie folgt abgebildet: 


Dim i, x as Integer 
For i = 1 to 100 
X=xt+i 
Next 
Wir haben meist darauf verzichtet, die Codebeispiele ins Deutsche zu tibersetzen. Erfahrungsgemafs ist dies nur eine 
weitere Fehlerquelle, die das Verstandnis eher erschwert als erleichtert. 


Macintosh Betriebssysteme 


Mit Mac OS X verwenden Macintosh-Computer jetzt ein modernes, auf Unix basierendes Betriebssystem, das mit Funkti- 
onen wie praemptivem Multitasking, dynamischer Speicherverwaltung, eingebauter Multiprozessorunterstiitzung und 
mit einem neuen Interface aufwartet. In der REALbasic Dokumentation werden Mac OS-Versionen vor Mac OS X unter 
dem Begriff Mac OS Classic zusammengefasst. 


Benutzen der Online-Referenz 


Eine elektronische Version der REALbasic-Sprachreferenz ist in REALbasic eingebaut. Sie ist unter Hilfe/Sprachreferenz 
zu finden (38-1 oder F1 unter Windows). 


Abb. 1: Die Online-Referenz 


Klicken Sie hier, um die e0°8 Sprachreferenz 
Befehle alphabetisch oder [# |i editableMovie Svinge 
nach Themen sortiert Pia - 
. EditableMovie Klasse 
aufzulisten 
> Fehlermeldungen Wird verwendet, um QuickTime-Movies (Filme) zu erzeugen, zu verandern und zu speichern. 
D> Fenster Ubergeordnete Klasse 
> Fonts edie 
> Grafik In friiheren REALbasic-Versionen war EditableMovie von Object abgeleitet. Da es nun von Movie 
> Klassen abgeleitet ist, konnen Sie ein EditableMovie unter Verwendung des MoviePlayer-Steuerelements 
» Konstanten anzengen. 
> Laufzeitfehler Eigenschaften 
5 Miatkarmanischs Name Typ Beschreibung 
an Duration Double Dauer des Filmes (in Sekunden) 
enue EOF Boolean True, wenn Position das Ende des Filmes ist 
> Monitore/Bildschirme Handle integer Liefert ein Handle auf das Editable Movie, meist fur 
> Multithreading | Toolbox~Aufrufe verwendet, die ein Handle auf 
einen Film benotigen. 
> Netzwerk Picture Picture Bild des Filmes an der aktuellen Position. 
> Objekte Position Double Aktuelle Position des Filmes (in Sekunden). 
4 Poster Picture Titelbild des Filmes. 
> Objektverkailpfung SaveOnClose Boolean Falls True, aktualisiert und speichert das Editable 
5 i > Operatoren Movie die Datei, wenn der Bereich verlassen wird 
sea tle > os (so wie in fruheren Versionen von REALbasic). 
auf um die Befehle peda Falls False, werden keine Aktualisierungen an der 
ces @y QuickTime EditableMovie-Datei vorgenommen, bis Sie die 
anzuzeigen EditableMovie Klasse CommitChanges-Methode aufrufen. 
GetOTCrassFadefffec SelLength Double Die Lange (in Sekunden) des gewahlten Segements 
= des EditableMovies. 
GetQTGraphicsExport... SelStart Double Die Start-Position (in Sekunden) des gewahiten 
GetQTSMPTEEEFfect (....“ Segments der EditableMovies. 
nontmininin oa. ¥ | TimeDuration Integer Dauer des Filmes in TimeScale-Einheiten. 


Alle Haupteintrage der gedruckten Referenz werden im Browser im linken Teil des Fensters aufgelistet. 

Sie konnen zwischen alphabetischer oder thematischer Anzeige wahlen. Klicken Sie hierzu auf einen der Kndpfe Alpha 
oder Theme. Wenn Sie mit der thematischen Liste arbeiten, konnen Sie die Sprachelemente eines Themas mit den Drei- 
ecken aus- und einklappen. 

Sie konnen einen Eintrag durch Anklicken des Namens im Browser anzeigen. Mit den Pfeilkndpfen im Kopfbereich k6n- 
nen Sie durch die bereits abgerufenen Eintrdge blattern. 
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Die Online-Hilfe durchsuchen 
Uber die Eingabezeile im Kopfbereich des Fensters konnen Sie die Online-Hilfe durchsuchen. 


Um nach einem REALbasic-Objekt zu suchen, mtissen Sie nur den Anfang seines Namens tippen. Dabei versucht REAL- 
basic, den vollstandigen Namen des Objekts zu erraten. Wenn es eine Vermutung hat, erscheint diese in grauer Schrift. 
Um diesen Vorschlag anzunehmen, kGnnen Sie die Tab-Taste driicken. Wenn es verschiedene Vorschlage gibt, erschei- 
nen drei Punkte. Nach Driicken der Tab-Taste erscheint ein Popup-Menii mit den Vorschlagen. Mit den Cursortasten 
k6nnen Sie den gewiinschten Eintrag ansteuern und dann Tab oder Return driicken, um ihn auszuwahlen. 


Hinweis: Die Suchfunktion unterstiitzt keine Mehrwortsuche, Sie kGnnen im Suchstring keine Leerzeichen verwenden. 


Klicken Sie auf Suchen oder driicken Sie die Return-Taste, um die Suche zu starten. Die Online-Hilfe zeigt die Seite im 
Text-Panel an. Ist der gesuchte Begriff im Browser sichtbar, wird er dort hervorgehoben. Sind im Browser nur die The- 
men eingeblendet, wird das Thema, das den gesuchten Begriff enthalt, hervorgehoben. 


Sie konnen auch nach einem Begriff suchen, fiir den es keinen eigenen Eintrag in der Sprachreferenz gibt. Ist REALbasic 
bei der Suche fiindig, werden im Browserbereich alle Seiten aufgelistet, die den gesuchten Begriff enthalten. 


Wenn REALbasic den Ausdruck nicht finden konnte, erscheint ,,Suche fehlgeschlagen“ im Browser-Panel. Der Knopf mit 
dem Hauschen im Kopfbereich bringt das Browser-Panel wieder in den Ursprungszustand zuriick und zeigt im Hauptpa- 
nel die Einfthrung der Sprachreferenz an. 


In den Einstellungen kénnen Sie den Suchen-Knopf in einen Springen-Knopf verwandeln. Wenn Sie auf Springen kli- 
cken, versucht die Online-Hilfe, genau das Objekt, nach dem Sie suchen, zu finden. Wenn Sie nicht nach einem Sprach- 
objekt suchen, halten Sie die alt-Taste gedriickt und wechseln zurtick auf Suchen. Die Online-Hilfe versucht dann, alle 
Sprachobjekte zu finden, die den gesuchten Ausdruck enthalten. 


Sie konnen den Browser auf die Standardansicht zurtickschalten, indem Sie entweder aufAlpha oder Theme klicken. 


Kontextsensitive Hilfe 


Die Online-Referenz ist kontextsensitiv. Wenn Sie also ein Steuerelement in der Entwicklungsumgebung selektieren und 
dann die Online-Referenz 6ffnen, erhalten Sie Informationen zum selektierten Steuerelement. Ebenso k6nnen Sie einen 
Befehl im Code-Editor selektieren und dann die Online-Referenz 6ffnen, um Hilfe zu diesem Befehl zu erhalten. 


Kontextsensitive Fehlermeldungen 


Beim Compilieren eines Programms kann REALbasic nur die korrekte Syntax des Quelltextes tiberpriifen, logische Feh- 
ler treten aber erst auf, wenn das Programm gestartet wird. Es kann also passieren, dass REALbasic auf einen Laufzeitfeh- 
ler sto&t. Dann erscheint im Code-Editor ein Tippsfenster mit einer kurzen Beschreibung des Fehlers. Das Tippsfenster 
enthalt einen Hilfe-Knopf. Wenn Sie diesen driicken, 6ffnet REALbasic die entsprechende Seite der Online-Hilfe mit 
einer detaillierten Fehlerbeschreibung. 


HyperText-Links 


HyperText-Links erscheinen in blauer Schrift und unterstrichen. Wenn Sie auf einen solchen Link klicken, verzweigt die 
Online-Referenz auf die Seite, auf der dieser Begriff erlautert wird. 
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Abb. 2: HyperText-Link und Code-Beispiel in der Online-Referenz: 


ee _ Sprachreferenz 
» recordSet == 
TS EBS EEF ET 
Alpha Eigenschaft der Database-Kiasse True. 
DatabaseRecord Klasse Die MoveNext-Methode entsperrt den aktuellen Datensatz, wenn Sie diesen zuvor mit Edit gesperrt 
DataControl Steuerele... hatten. Es ruft auherdem die Close-Methode der Klasse auf und die Close-~Methode der Database~ 
Klasse. 


NewREALDatabase (F... 
Wenn Sie OpenBase als Datenquelle verwenden und die RecordSet-Klasse mit Edit und Update zum 


ODBCDatabase Klasse Aktualisieren eines Datensatzes verwenden, miissen Sie die “_rowid”-Spalte der Tabelle hinzufiigen. 
Open4DDatabasebyA... Wenn Sie dies nicht machen, ist OpenBase nicht in der Lage, den Datensatz zu finden, um ihn zu 
Open4DDatabasebyT... aktualisieren. 
OpenBaseDatabase Ki..M?  Beispiele 
OpenCSVCursor Meth rt ein Feld und aktualisiert die Tabelle. 
NDBFCursor (Fold... 
eee . a | dim rs as RecordSet 
OpenODBCDatabase (. a 
OpenOpenBaseDatab.. [rs = db.SQLSelect("select * from employees where ID=01") 
OpenOracleDatabase pps. Edit 
aor rs. IdxField(2).setString ("VP") 

Code-Beispiel ——S ou Uieslesea 
OpenREALDatabase (f. | db Commit 
ore ids a Siehe auch 

HyperText-Links tEALDatahase Klassé_| | @ Database, DatabaseField, ODBCDatabase ADSP4DDatabase, TCPIP4DDatabase, PostgreSQLDatabase,Op 4 


RecordSet Klasse 4 
Select4DDatabaseByA... ¥ 


enBaseDatabase Klassen. 


Code-Beispiele 


Die Online-Referenz enthilt eine Menge Code-Beispiele. Diese sind an dem Rechteck, das sie umgibt, zu erkennen. Sie 
konnen solche Code-Beispiele mit der Maus aus dem Referenzfenster in das Editorfenster ziehen, um den Beispielcode 
in Ihrem Programm zu verwenden. 


Bei manchen Code-Beispielen wurde aus Griinden der Ubersichtlichkeit ein Teil des Codes weggelassen. Dieser wird 
durch Punkte dargestellt. Hier konnen Sie Ihren eigenen Code einftigen. Des weiteren enthalten einige Beispiele Unter- 
programme oder Funktionen, die automatisch vom Code-Editor hinzugeftigt werden. Wenn Sie ein solches Beispiel in 
den Code-Editor draggen, miissen Sie die doppelten Anweisungen entfernen. 


Tipps anwenden 


Wahrend Sie arbeiten, ,beobachtet“ die IDE Ihre Aktivitaten und zeigt Hinweise in einem Tippsfenster an. Wenn Sie zum 
Beispiel Quelltext eingeben, erinnert Sie das Fenster an die korrekte Syntax der Methode, die Sie gerade eingeben. 


Abb. 3: Beispiele fiir Tipps 


| @ GetSaveFolderitem(filter, defaultName) As e| a) “Endif* ist keine giiltige Syntax. Versuchen 
| Folderitem | Sie stattdessen "End If". 


Fehlermeldungen Hilfe-Tipps Syntax fiir Methoden 


Uber das Kontextmenii des Tippfensters kdnnen Sie bis zu 5 der vorangegangenen Tipps abrufen oder einen zufilligen 
Tipp anzeigen. Um in das Kontextmenii zu gelangen, halten Sie tiber dem Textbereich des Tippfensters die Befehlstaste 
gedriickt und driicken dabei die Maustaste (unter Windows die rechte Maustaste). 


Abb. 4: Das Kontextmenii des Tippfensters 


| em GetSaveFolderitemifilter, defaultName) As 
| Folderitem 


Zufalligen Tipp zeigen 

Driicken Sie die... 

GetSaveFolderitem(f... 
Sie konnen bestimmte Tipps im Einstellungen-Dialog deaktivieren. Wahlen Sie dazu den Meniipunkt Bearbeiten/ 
Einstellungen (bzw. unter Mac OS X REALbasic/Einstellungen). Wechseln Sie auf die Dialogseite Tippfenster und 
deaktivieren Sie die nicht erwiinschten Tipps. 
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Abb. 5: Tipps-Einstellungen 


Online-Hilfe 


REALbasic IDE Voreinstellungen 
Tips—Fenster 


Zeige Tips fur: 
w Funktions-Notizen 


w Information 


Tips-Fenster vw Warnungen 
oa M Fehler 
ezeugen-Pose soundtrack: (Rotover fa) {Q)| 


Sie kénnen auch alle Tipps verstecken (oder sich anzeigen lassen), indem Sie den Mentipunkt Fenster/Tipps 
ausblenden bzw. Fenster/Tipps einblenden aufrufen. 


Abb. 6: Der Meniipunkt Tipps ausblenden/Tipps einblenden 


© Fenster verkleinern 38M 
@ Fenster zoomen 96/ 


=. Alle nach vorne bringen 


_-2 Steuerelemente ausblenden “C31 
= Zeige Eigenschaften 82 
GB Zeige Farben 83 


Tipps ausblenden X84 


Zeige AE Recorder 


[=] Projekt #0 


Namenlos (Fenster1) 2 


Weitere Informationsquellen 


Elektronische Dokumentation 


Die gesamte Dokumentation von REALbasic ist auf der CD enthalten oder im Internet zu finden unter: 
http://www.realsoftware.de (deutsche Version) bzw. 
http://www.realsoftware.com (englische Version). 


Die Dokumente liegen als PDF-Dateien vor und k6nnen somit einfach durchsucht werden. Die PDF-Version der Sprach- 
referenz enthalt die gleichen Hyperlinks wie die Online-Hilfe. 


Support im Internet 


Support im Internet finden Sie unter: 
http://www.application-systems.de/support (deutschsprachig) bzw. 
http://www.realsoftware.com/support (englisch). 


Weiterfiihrende Literatur zu REALbasic 


REALbasic Developer (http://www.rbdeveloper.com) ist ein Magazin rund um REALbasic. Hier werden Artikel sowohl 
von REALbasic-Benutzern als auch von den Entwicklern selbst verdffentlicht. 


REALbasic for Dummies (ISBN: 0764507931) von Erick Tejkowski bietet eine Einfiihrung in REALbasic und in die objekt- 
orientierte Programmierung fiir Anfinger. Es ist eine hervorragende Quelle Neueinsteiger. 
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Ein exzellentes Buch ist REALbasic: The Definitive Guide, zweite Auflage von Matt Neuburg (ISBN 0-596-00177-0). Es 
enthalt viele Tipps und Tricks und Programmiertechniken. Sie konnen das Buch direkt tiber Application Systems Heidel- 
berg beziehen. 


Die REALbasic CD 


Wir liefern REALbasic auf einer CD-R aus, damit wir immer gewahrleisten konnen, den aktuellen Stand der Entwicklung 
herauszugeben. Gegen eine geringe Gebiihr k6nnen Sie jederzeit eine FreshUp-CD erhalten, die den gerade aktuellen 
Stand Ihrer REALbasic-Version enthalt. 


Die Internet Mailing-Lists 


Es existieren verschiedene Internet-Mailing-Lists, in denen REALbasic Gegenstand der Diskussion ist. Sie konnen sich in 
der englischsprachigen oder auch in der deutschsprachigen Mailing-Liste eintragen. Hier konnen Sie Fragen stellen oder 
einfach nur mitlesen und natiirlich anderen REALbasic-Benutzern helfen, die Fragen stellen, zu denen Sie Antworten 
kennen. Sie konnen sich auf folgenden Web-Seiten zu den Mailing-Lists informieren: 
http://www.application-systems.de/realbasic 

http://www.realsoftware.com 


Application Systems Heidelberg 


So kénnen Sie Application Systems Heidelberg kontaktieren: 


Application Systems Heidelberg Software GmbH 
Pleikartsforsterhof 4/1 

69124 Heidelberg, Deutschland 

Tel.: 06221-300002, Fax: 06221-300389 


E-Mail: support@application-systems.de 


Fehler melden und Vorschlage mitteilen 


Wenn Sie einen Fehler in REALbasic gefunden haben oder einen Vorschlag zur Erweiterung von REALbasic machen wol- 
len, lassen Sie es uns wissen. 


Wenn Sie keinen Internet-Anschluss haben, dann konnen Sie auch den normalen Postweg oder ein Fax verwenden. 


Alpha- und Beta-Versionen 


Alle REALbasic-Kaufer haben kostenlosen Zugang zu den aktuellen Alpha- und Betaversionen der nachsten REAL- 
basic-Release. Diese stehen (in englischer Sprache) unter http://www.realsoftware.com so lange zur Verftigung, bis die 
nachste Release ver6ffentlicht wird. 
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xite2 Der Einstieg in REALbasic 


Manche Probleme k6nnen Sie mit REALbasic binnen weniger Minuten ldsen. Zunichst legen Sie das Benutzer-Interface 
an, das aus Meniis und Fenstern mit Steuerelementen besteht. Danach hauchen Sie mit ein paar Programmzeilen dem 
Benutzer-Interface Leben ein. 


Dieses Kapitel gibt Ihnen einen Uberblick tiber die Entwicklungsumgebung und die Arbeit mit REALbasic-Projekten. 


Inhalt 


© Das Grundprinzip 
© Die Integrierte Entwicklungsumgebung (IDE) 
© Die Arbeit mit Projekten 


Das Grundprinzip 


Einige grundlegende Prinzipien miissen Sie verstehen, um mit REALbasic programmieren zu k6nnen. 


Events steuern Programme 


Bevor Computer grafische Benutzerschnittstellen hatten, wurden Programme als eine Reihe von Befehlen entworfen, 
die vom ersten Befehl an abgearbeitet wurden, bis eben der letzte Befehl ausgefiihrt wurde. Die Eingaben des Benutzers 
wurden nur in Form von Zeichen entgegengenommen. Ein Menti bestand aus durchnumerierten Kommandos, die man 
iiber die Tastatur auswahlen konnte. Die meiste Zeit warteten die Programme auf eine Benutzerarktion, normalerweise 
eine Tastatureingabe. 


Mit den heutigen grafischen Benutzerschnittstellen hat sich das geandert, denn der Benutzer kann erheblich intuitiver 
mit dem Programm kommunizieren. Die Programme warten heute immer noch auf Ereignisse, sogenannte Events. Der 
Unterschied liegt darin, dass es heutzutage jede Menge verschiedene Events gibt, die auftreten k6nnen. Friiher waren 
die Programme modal. Das bedeutet, dass es einen Wartemodus gab, in dem das Programm auf ein Event wartete und 
einen Ausfiihrungsmodus, in dem eine Aktion ablief. Mit einem grafischen Benutzerinterface hat der Benutzer jedoch 
sehr vielfaltige Méglichkeiten, auf ein Programm einzuwirken. Der Benutzer kann relativ frei entscheiden, ob er einen 
Mentipunkt anwahlt, auf einen Knopf klickt oder Daten in ein Feld eintippt. AuSerdem kann es sein, dass Programme 
selbst Events auslosen konnen, die nur indirekt etwas mit Eingaben des Benutzers zu tun haben, wenn beispielsweise 
ein Fenster geéffnet oder in der Grofe verindert wird. 


REALbasic erleichtert es ziemlich, mit allen diesen Events umzugehen. Sie k6nnen sehr einfach herausfinden, welche 
Events in Ihrer Anwendung eine Rolle spielen konnen. Soll Ihr Programm auf ein Event reagieren, miissen Sie nur das 
Steuerelement auswahlen, das das Event empfangen wird. Dann sehen Sie die méglichen Events, die es empfangen kann 
und kdnnen dazu entsprechende Unterprogramme eingeben. Detailliertere Erlduterungen zu den Events finden Sie wei- 
ter hinten in diesem Handbuch. 


Programmieren mit REALbasic 


Wenn Sie mit anderen Programmiersprachen bereits Erfahrungen haben, dann wissen Sie bereits, dass die Program- 
mentwicklung drei Stufen hat: Code schreiben, compilieren (dabei wird das Programm in etwas tibersetzt, das der Com- 
puter wirklich versteht) und testen. Gibt es noch Probleme bei der Ausftihrung, dann geht es wieder von vorne los. Man 
spricht hier auch von Turnaround und im Zusammenhang mit der Entwicklung ist die Turnaround-Zeit interessant, die 
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sehr wesentlich davon abhingt, wie lange man beim Compilieren warten muss, denn Anderungen am Programm erfor- 
dern immer wieder das Compilieren, um dann im Test wiederum herauszufinden, ob weitere Anderungen erforderlich 
sind. REALbasic beschleunigt diesen Prozess dadurch, dass der Compiler sehr schnell ist. Deswegen kann man auch 
nach kleineren Anderungen immer schnell mal testen, ob es so funktioniert, wie man sich das vorstellt, wahrend man 
bei anderen Entwicklungssystemen immer zunichst sehr viel programmiert, dann einen Compilerlauf startet, der einige 
Zeit bendtigt, um dann viele neue Funktionen zu testen, was den Entwicklungsprozess insbesondere ftir Anfanger auch 
komplizierter gestaltet. 

Der REALbasic-Compiler weist Sie gleich auf syntaktische Fehler in Ihrem Programm hin. Dabei hebt er direkt im Editor 
die Stelle im Programm hervor, an der der Fehler aufgetreten ist. 


Die Entwicklungsumgebung 


REALbasic arbeitet mit einer integrierten Entwicklungsumgebung (Integrated Development Environment — kurz IDE). 
Das heifst, dass alles, was man zum Erzeugen eines Programms benotigt, in einer Applikation zusammengefasst ist: Ein 
Interface-Builder, ein Code-Editor, ein Compiler und ein Debugger. In traditionellen Programmiersprachen waren diese 
Teile jeweils ein eigenes Programm. Die IDE von REALbasic besteht aus folgenden Objekten: 


Die Meniis 
Die Meniileiste bietet Meniis fiir folgende Aktionen: 


Bearbeiten von Projekten 

Compilieren von Projekten in eigenstindige, durch Doppelklick startbare Programme 
Erzeugen neuer Fenster 

Einstellen der Zeichensatze, des Stils und der Grofse der Objekte des Benutzerinterfaces 
Positionieren der Objekte im Interface 

Testen und debuggen der Projekte 

Zugriff auf Objekte, die sich im IDE Extras-Ordner im REALbasic Ordner befinden 

Auf Informationen der Online-Hilfe und Web-Site zugreifen 


Das Projektfenster 


Ein Projekt ist die Sammlung aller Elemente, die in einem Programm bendtigt werden. 


Abb. 7: Das Projektfenster 


@ © © TextEditor 
f= TextFenster 
iy Mena 
(gal App 
ia Modull 
fos Logo 
® Hintergrundbild 
@) Tahtah 
) Whoosh 
fe AenderungenSichern 


Das Projektfenster zeigt alle diese Elemente. Beispielsweise erscheinen hier alle Fenster Ihres Programms, Bilder, 
Sound-Dateien, REAL-Datenbanken, QuickTime-Filme, Ressourcen oder andere Elemente, die Sie in Ihrem Programm 
verwenden. Abbildung 7 zeigt beispielsweise ein Projekt mit einem Quicktime Film und einem Bild. Mehr dazu im nachs- 
ten Kapitel. 
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Der Fenster-Editor 


Im Fenster-Editor wird das Aussehen der Benutzerschnittstelle festgelegt. 


Abb. 8: Ein Fenster im Fenster-Editor 


eee Outgoing Message: © Send Mail Demo 
mee SMTP Settings: 
f Recipients | Enclosures T-] Server. | mairealsotware.com | Usemame: | 
Csi Authenticate Password | 


a 


7 


Send Via: ay Send Message {Later Now ) ‘8 
—— — < A Subject: 
Signature: i) 


Body: 


Mit einem Doppelklick auf ein Fenster, das im Projektfenster aufgeftihrt ist, Gffnet sich der Fenster-Editor. Sie konnen im 
Fenster-Editor Ihrem Benutzer-Interface jede Art von Steuerelement hinzufiigen und Steuerelemente entfernen oder 
andern. Auerdem erreichen Sie hier den zu einem Steuerelement geh6renden Programmcode. 


Die Steuerelementepalette = 
In der Steuerelementepalette finden Sie alle Werkzeuge, mit denen Sie Steue- CO ——— 
relemente in Ihr Benutzer-Interface einftigen kOnnen und vorhandene Steue- , — = — 
relemente entfernen oder ‘ndern kénnen. Steuerelemente sind 9» ¥ oO un 50 
Interface-Elemente, wie z.B. Buttons, Checkboxen, Texteingabefelder, Listen, © pees 

TabPanel, Pop-Up Meniis oder ein Movie-Player. Dazu ziehen Sie einfach das = —— 


LockTop: [ } 


LockRight: 
ca] 


LockBottom: 


gewtinschte Steuerelement aus der Steuerelementepalette auf das Fenster im 
Fenster-Editor. 


‘aussehen 
Caption: Namenlos (2) 
Das Eigenschaftenfenster cnet 3 
Enabled: 
Eigenschaften (Properties) sind Werte, die zu einem bestimmten Steuerele- ene ss e 
ee BalloonHelp: e 


ment gehoren. PushButtons haben beispielsweise die Eigenschaft Caption, ““——== 
g u u ISP1elswi ig p Py Kp Wha DisabledBalloonH... 


die den Beschriftungstext ftir den PushButton enthilt. Die Namen der Eigen- AutoDeactivate A 
|Sehetfe 
schaften sind englisch, weil die Programmiersprache sie verwendet und auch TextFont: System e 
TextSize: 12 
die Befehle der Programmiersprache englisch bleiben. Bold: 
Italic: () 
PushButtons haben auerdem die Eigenschaften Left, Top, Width und Undertine: 


Height, die Position, Breite und Hohe des Knopfes angeben. Die Eigenschaf- 
ten, die im Eigenschaftenfenster erscheinen, konnen hier direkt geandert werden. Sie gelten fiir das jeweils in der Ent- 
wicklungsumgebung selektierte Element. Es Eigenschaften, die man nur per Programmcode verandern kann andere 
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Eigenschaften, die méglicherweise nur im Eigenschaftenfenster veranderbar sind. Das Aussehen des Eigenschaftenfens- 
ters hangt davon ab, welches Objekt selektiert ist. Es kann zur gleichen Zeit immer nur ein einziges Eigenschaftenfenster 
offen sein. 


Das Farbenfenster 


Farben werden in Werten von 0 bis 255 angegeben. Die 16 Farben, die Sie am haufigsten in Ihrem Projekt © Farben 
verwenden, kénnen Sie im Farbenfenster ablegen. Wenn Sie auf eine Farbe im Farbenfenster klicken, 
wird der Farbauswahl-Dialog angezeigt, mit dem Sie dem Feld eine neue Farbe zuordnen kénnen. Ein 
solches ,,Farbobjekt“ kénnen Sie einfach mit der Maus auf die Color-Eigenschaft eines Objekts ziehen, 
um diesem Objekt die entsprechende Farbe zuzuordnen. Dies gilt sowohl fiir die Color-Eigenschaft im 
Eigenschaftenfenster als auch ftir die Color-Eigenschaft direkt im Code des Code Editor. 


Das Code-Editorfenster 


In diesem Fenster wird der Programmcode bearbeitet, der Fenstern und Steuerelementen zugeordnet ist. Im Browser 
sind diese Elemente und ihre Events leicht zuginglich. 


Abb. 9: Der Code-Editor (mit zwei Arbeitsbereichen) 


Code Editor (demoWindow) 


= &® Controls Sub Actiond 
Aa StaticT enti socket! address = nthField(serverFld.text,"",1) 
Aa StaticText2 sockett .port= val(nthField(serverFld.tent,":",2)) 
[20 ListBox1 if sockett port= 0 then 


@ PushButton1 socket1.port= 110 
®) Action 

& ProgressBarl 

© PushButton2 
® Action 

@ Socket! 


= ConnectionE stabli... 


= LoginSuccessful 
7 
3 MessageReceived 
= ServerEnror 
=) TopLinesRetrieved 
Aa StaticText3 
1 serverFid 
(7 usermameFid 
(7) passwordFid 
1) bodyFid 


end 


socket! username = usernameFld.text 
socket! password = passwordFld text 


socket! connect 


Sub MessageCount(count as integer) 
list8oxt deleteallRows 


ifcount= 0 then 
msgBox"No messages were found.” 
me.disconnectFromServer 
return 

end 


messageTotal = count 
me.retrieveLines 1,0 


End Sub 
 g9 Events nee 


Bie» 


Der Arbeitsbereich des Code-Editors kann in ein oder mehrere Felder unterteilt werden. So konnen Sie zwei oder mehr 
Methoden gleichzeitig bearbeiten. Voreingestellt ist ein zusammenhangender Arbeitsbereich. 


Der Ment-Editor 


Im Menii-Editor werden die Mentis des Programms entworfen. 


Abb. 10: Der Menii-Editor 
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Sie kénnen einzelnen Mentipunkten Tastaturkommandos zuordnen oder auch Untermentis anlegen (dabei ist dem 
Meniipunkt dann einfach ein neues Menii zugeordnet). REALbasic legt in der deutschen Version automatisch die Mentis 
Ablage und Bearbeiten an. 


Das Extras Menu 


Das Extras-Menii verschafft Ihnen unmittelbaren Zugang zum IDE Extras-Ordner innerhalb des REALbasic Ordners. 


Abb. 11: Das Extras-Menii 


© Extras-Ordner 6ffnen 


Block Comment Old Basic Style 
Lookup in Dictionary 

New Variable 

Templates > 
Textwrap- Unwrap 

Textwrap- Wrap 

Translate Text 

Web-links > 


Das Extras-Menii enthiilt einen Befehl zum Offnen des Ordners und Mentibefehle fiir alle Objekte im Wurzelverzeichnis 
des Ordners. Das macht es zum perfekten Aufbewahrungsort fiir Ihre Module, Ihre persnlichen Fenster-Vorlagen, Klas- 
sen und Codeschnipsel genauso wie fiir alle Anwendungen, die Sie im Zusammenhang mit REALbasic verwenden. Die 
Vorlagen, die mit REALbasic geliefert werden, haben die Form von Text-Clips, die in den Code-Editor gedraget und dort 
modifiziert werden k6nnen. Jedes eigene Objekt (Module, Klassen etc.), das Sie hinzuftigen, kann in das Projektfenster 
gedraggt werden. 


Das Hilfe Meni 


Uber das Hilfe-Menii haben Sie sowohl Zugriff auf die REALbasic Sprachreferenz als auch auf Online-Informationen von 
der REALbasic-Website. Das Hilfe-Menti besteht aus drei Mentipunkten: 


© Sprachreferenz: Offnet die Sprachreferenz. 

e REALbasic Info: Offnet den Standard-Webbrowser und geleitet Sie zur Website von REAL Software 

@ REALbasic Feedback: Offnet die Feedback-Seite von REALbasic. Dort kdnnen Sie Fehler melden und Wiinsche fiir 
neue Funktionen eingeben. Sie k6nnen die Feedback-Datenbank nach Stichwortern durchsuchen. 


Die Windows IDE 


Die Windows IDE unterscheidet sich von der Macintosh IDE dahingehend, dass sie in einem MDI-Fenster (Multiple 
Document Interface) angezeigt wird. Code-Editor, Fenster-Editor und Projektfenster befinden sich in dem MDI-Fenster, 
wahrend die Steuerelementepalette-, das Eigenschaften- und das Farbenfenster schwimmende Fenster sind, die auch 
aus dem MDI-Fenster gezogen werden kénnen. 


Unter Windows haben Sie die Méglichkeit, die Steuerelementepalette und das Eigenschaftenfenster an den Rand des 
MDI-Fensters anzudocken. Die Steuerelementepalette konnen Sie auch an die Unterkante des MDI-Fensters andocken. 


Um ein Fenster anzudocken, wahlen Sie den Mentipunkt Fenster/Docking fiir das jeweilige Fenster und dann die Seite 
aus, an die das Fenster angedockt werden soll. Dieses Menii wird nur unter Windows angezeigt. 
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Die Arbeit mit Projekten 


In einer Projektdatei sind alle Elemente gespeichert, die zu einem Programm gehoren. Dies sind der Programmcode, 
Plugins, Fenster, die Meniileiste, Klassen, Klassen-Interfaces, Module, Bilder, Sounds, QuickTime-Filme, Datenbanken, 
AppleEvent-Vorlagen, AppleScript-Skripts, PPC Shared Libraries, Resource-Dateien (nur Mac OS), Cursor-Resources, 
Ordner und andere Arten von Dokumenten, die als Textstrings behandelt werden. Jedes Element besitzt ein Icon, das 
seinen Typ anzeigt. 


Mit einem Doppelklick auf einen Eintrag im Projektfenster wird das Element angezeigt oder ein Viewer ge6ffnet, der es 
anzeigt, falls REALbasic selbst keine Funktion dazu hat. Das funktioniert nicht mit Objekten, die gesperrt sind. Ein Objekt 
(z.B, eine Klasse) kann von ihrem Entwickler gesperrt werden, damit niemand Zugriff auf den Quelltext hat. So ist es 
moglich, Erweiterungen fiir REALbasic zu entwickeln und zu verkaufen. Wenn Sie einen Doppelklick auf ein gesperrtes 
Objekt ausfiihren, zeigt REALbasic eine Warnbox an, die mitteilt, dass das Objekt geschiitzt ist. 


Anlegen eines neuen Projekts 


Wenn Sie den Meniipunkt Ablage/Neu (Windows: Datei/Neu) aufrufen, wird der Projekt-Dialog angezeigt. Hier kon- 
nen Sie eine Projektvorlage auswahlen. Standardmafsig werden zwei Eintrige angezeigt: 


Desktop-Applikation: Verwenden Sie diese Vorlage fiir eine Standard-Applikation mit grafischer Benutzeroberflache 
(GUD). Projekte, die ein GUI enthalten, besitzen ein Fenster und ein Menii. Wenn in diesem Entwicklerhandbuch von 
einem REALbasic-Projekt die Rede ist, ist immer eine Desktop-Applikation gemeint. 


Kommandozeilen-Applikation: Vorlage fiir eine REALbasic-Applikation, die in einem Terminalfenster (Mac OS X und 
Linux) bzw. in der Kommandozeile (Windows) ausgeftihrt wird. Verwenden Sie diese Vorlage nur, wenn Thre Applikation 
kein GUI benotigt, wie zum Beispiel ein Webserver. Fiir weitere Informationen lesen Sie die Sprachreferenz zum Thema 
Kommandozeilen-Applikation. 


Standardmaisig enthalt das Projekt einer Desktop-Applikation drei Objekte: Fenster1, Meniileiste1 (das Objekt, das die 
Meniileiste und die Meniieintrage des Programms enthilt) und eine spezielle Klasse namens App, die zur Steuerung von 
globalen Programmfunktionen dient. 


Wenn Sie ein neues Projekt tiber eine Projekt-Vorlage erzeugen, enthalt das Projektfenster alle zusatzlichen Objekte, die 
mit dem Projekt gespeichert wurden, als die Projekt-Vorlage erzeugt wurde. 


Hinzufiigen von Elementen zu Ihrem Projekt 


Ein neues Fenster wird tiber den entsprechenden Mentipunkt angelegt, wahrend ein Bild, Sound, QuickTime-Film oder 
eine REAL-Datenbank durch Draggen der Datei vom Desktop auf das Projektfenster in das Projekt importiert wird. Wenn 
REALbasic ein Alias auf ein externes Objekt speichert, wird dieses kursiv im Projektfenster dargestellt. 


Externe Projektelemente 


Es ist méglich, Fenster, Klassen oder Module, die in einer externen Datei aufbewahrt werden, in ein Projekt einzubinden. 
Dieses Feature dient dazu, mehr als einem Projekt den Zugriff auf das extern vorliegende Element zu erméglichen. Wenn 
Sie in REALbasic ein extern vorliegendes Element verandern und ihr Projekt speichern, dann werden die von Ihnen vor- 
genommenen Veranderungen in der externen Datei auf der Festplatte gespeichert. Wenn Sie irgendein anderes Projekt 
offnen, das auf die gleiche Datei verweist, wird dieses Projekt die Verdnderung tibernehmen. REALbasic erlaubt Ihnen 
jedoch nicht, mehr als eine Kopie von REALbasic zu 6ffnen, die zeitgleich auf das gleiche externe Element zugreift. 

Sie konnen ein Element, das als externe Datei verwendet werden soll, tiber das Projektfenster in ein externes Element 
umwandeln. Klicken Sie dazu mit gleichzeitig gedriickter ctrl-Taste (Windows: rechte Maustaste) auf das Element, rufen 
das Kontext-Menti auf und wahlen dort die Funktion Externes Element erzeugen aus. Darauf hin erscheint eine ,,Datei 
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sichern*-Dialogbox. Sichern Sie das Element im Format ,,Standard-Projektbestandteil. Dann wird das Element im Pro- 
jektfenster durch einen Verweis (Alias) auf das Element ersetzt. Eine Alias-Markierung im Icon des Elements zeigt an, 
dass das Element nun auerhalb des Projektes liegt und in andere Projekt importiert werden kann. 

Wenn Sie ein Element von Ihrem Schreibtisch als externes Element in Ihr Projekt einfiigen wollen, halten Sie die Befehls- 
und die alt-Taste (Strg- und Shift-Taste unter Windows) gedriickt, wahrend Sie das Element von Ihrem Schreibtisch in 
das Projektfenster ziehen. Das Symbol des Elements im Projektfenster tragt dann eine Alias-Markierung und der Name 
erscheint in kursiven Buchstaben. 


Abb. 12: Externes Modul 
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Wenn Sie ein Projekt, das externe Elemente enthalt, abspeichern, erscheint eine ,,Sichern als“-Dialogbox fiir jede externe 
Datei und anschliefend eine fiir das Projekt selbst. Dies erméglicht Ihnen, Ihre geanderten Projekt-Elemente an einem 
neuen Ort abzuspeichern und die Originale unangetastet zu lassen. Externe Projekt-Elemente, die Sie nicht verandert 
haben, werden in diesem Verfahren nicht beriicksichtigt. 

Sollte ein externes Projektelement im Finder gesperrt sein, kGnnen Sie es in REALbasic nicht verandern, aber trotzdem 
anzeigen. So werden externe Elemente (die eventuell von mehreren Projekten verwendet werden) vor versehentlichen 
Veranderungen geschiitzt. Dadurch besteht auch die Mdglichkeit, REALbasic in Verbindung mit Versions- 
kontrollsystemen zu verwenden, die den ,,checked in/out-Status mit Hilfe von Dateiattributen abbilden. 


Beachten Sie: Wenn eine externe Datei auf der Festplatte von einem anderen Programm als REALbasic geandert wird — 
wie z.B. einem Versionskontrollsystem — miissen Sie das Projekt neu laden, um auch dieses Element neu zu laden). 


Entfernen von Elementen aus Ihrem Projekt 


Entfernen kann man Elemente, indem man sie selektiert und die Delete-Taste driickt oder indem man das Objekt selek- 
tiert und den Meniipunkt Bearbeiten/Léschen aufruft. Sie konnen dazu auch, wie im folgenden beschrieben, das Kon- 
textmenii verwenden. 


Das Kontextment des Projektfensters 


Das Projektfenster hat ein eigenes Kontextmenii. Fiihren Sie einen ctrl-Klick (Macintosh) oder Rechtsklick (Windows) 
auf ein Projekt-Objekt oder eine freie Stelle des Projektfensters aus, um das Kontextmenti aufzurufen. Die Eintrage des 
Meniis hangen vom Objekttyp ab und kénnen folgende Eintrdge enthalten: 


© Bearbeiten: Offnet das Objekt zum Bearbeiten in REALbasic. Handelt es sich um ein Modul, wird der Code-Editor 
fiir das Modul ge6ffnet. Wenn das Objekt ein Film ist, wird dieser mittels QuickTime gedffnet. Sie kGnnen Dateien 
auch einfach durch einen Doppelklick auf das Objekt im Projektfenster Gffnen (wenn das Objekt gesperrt ist, steht 
der Meniieintrag Bearbeiten nicht zur Verfiigung). 

© Fenster bearbeiten: Dieser Mentipunkt steht zur Verfiigung, wenn es sich bei dem Objekt um ein Fenster handelt. 
Er 6ffnet das Fenster im Fenster-Editor. 

© Code bearbeiten: Offnet den Code-Editor fiir das Fenster, Dieser Meniipunkt wird nur dann angezeigt, wenn es sich 
bei dem Objekt um ein Fenster handelt. 

@ Léschen: Entfernt das Objekt aus dem Projekt. 
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© Ansicht: Zeigt das Objekt (z.B. ein Bild) in REALbasic an, bietet Ihnen aber nicht die Méglichkeit, es zu bearbeiten. 

e Abspielen: Dieser Meniipunkt ist nur fiir eine Sounddatei verfiigbar. Spielt den Sound ab. 

© Datei dffnen: Offnet die Datei so, als wiirde sie auf dem Schreibtisch doppelt angeklickt. Wenn das Objekt z.B. ein 
QuickTime-Film ist, wird es im QuickTime-Player geéffnet. 

e Auf Festplatte anzeigen: Offnet den Ordner der Datei und selektiert die Datei. 

© Dateipfad: Zeigt fiir das externe Element ein hierarchisches Menti, tiber das man jeden Ordner innerhalb des 
Zugriffspfades 6ffnen kann. 

© Erneut suchen: Gilt nur ftir externe Projektelemente. Ruft eine Datei 6ffnen“-Dialogbox auf, in der Sie ftir das 
Objekt eine neue externe Datei auswahlen konnen. 

© Verschliisseln: Ruft die Verschltisseln-Dialogbox auf und erlaubt Ihnen, ein Passwort einzugeben und das Objekt zu 
verschliisseln. Diese Funktion wird normalerweise dazu verwendet, Code von Modulen zu verstecken, die Sie ande- 
ren Entwicklern anbieten oder verkaufen. Nur verftigbar, wenn das Objekt nicht bereits verschliisselt ist. Elemente, 
die ihren Ursprung auferhalb von REALbasic haben, so wie z.B. Filme, Musik und Bilder, konnen nicht verschliisselt 
werden. 

© Entschliisseln: Ruft die Entschliisseln-Dialogbox auf und fordert Sie auf, das Passwort zum Entschliisseln einzuge- 
ben. Ein verschliisseltes Objekt wird im Projektfenster mit einem Schloss in der linken unteren Ecke des Icons ange- 
zeigt. Nur verfiigbar, wenn das Objekt verschliisselt ist. 

© Neu: Wird verwendet, um einem Projekt ein neues Objekt hinzuzufiigen und hat die gleiche Funktion wie die ent- 
sprechenden Meniipunkte aus dem Ablage- (Windows: Datei-) Menii. 

© Neue Unterklasse: Erscheint nur, wenn das ausgewdhlte Element im Projektfenster eine Klasse ist. Erstellt eine 
neue Klasse, fiigt sie dem Projektfenster hinzu und passt ihre ,,Super‘-Klasse-Eigenschschaft automatisch der ausge- 
wahlten Klasse an. Die neue Klasse enthalt automatisch den Namen BenutzerdefiniertKlasse, wahrend die 
,super“-Klasse-Eigenschaft den eigentlichen Klassennamen tragt. Nachdem Sie die Unterklasse angelegt haben, k6n- 
nen Sie mit Hilfe des Eigenschaftenfensters alle notigen Anderungen an der Unterklasse vornehmen, inklusive ihrer 
SuperClass-Eigenschaft. 

© Exportieren: Exportiert das Element auf die Festplatte. Es erscheint eine Datei sichern“-Dialogbox. Sie konnen das 
Element in ein anderes Projekt importieren, indem Sie es vom Schreibtisch auf das Projektfenster ziehen oder es als 
externes Element importieren. Beim Import als externes Element verbleibt das Element auf der Festplatte und kann 
in mehreren Projekten gleichzeitig genutzt werden. Dazu miissen Sie die Befehls-(¢8) und Wahltaste(~) gedriickt hal- 
ten (Ctrl/Strg und Shift unter Windows) wahrend Sie das Element vom Schreibtisch auf das Projektfenster ziehen. 

e Externes Element erzeugen: Zum Abspeichern eines Elements als externe Datei auf der Festplatte. Im Unterschied 
zu Exportieren wandelt Extern machen auch das Element des aktuellen Projekts in ein externes Element um. 
Genauso wie bei exportierten Elementen kann die Kopie auf dem Schreibtisch in andere Projekte importiert werden. 

© Sichern: Nur fiir externe Projektelemente. Ruft eine ,Datei sichern“-Dialogbox auf und erméglicht Ihnen, das 
externe Projektelement auf der Festplatte zu speichern. Dieser Kontextmeniieintrag erscheint nur, wenn Sie an 
einem externen Projektelement Anderungen vorgenommen haben. 


Abb. 13: Das Kontextmenii eines externen Projektelements 
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Das Projekt speichern 


Anderungen am Projekt sichert man tiber Ablage/Sichern (Windows: Datei/Sichern). Speichern Sie das Projekt so oft 
wie méglich. Wenn Sie sich nicht sicher sind, ob Sie die Anderungen, die Sie gerade vornehmen, spiter behalten mich- 
ten, sichern Sie das Projekt mit Sichern als unter einem neuen Namen. Dann haben Sie das urspriingliche Projekt noch 
in der alten Fassung. Wie bereits erwahnt, kénnen Sie externe Projektelemente unabhangig vom Projekt tiber deren 
Kontextmentis sichern. 


Im XML-Format speichern 


Projekte konnen auch im XML-Format gespeichert werden. Rufen Sie dazu den Menitipunkt Sichern als auf und wahlen 
Sie im Format-Popup XML. Dann wird das Projekt in eine XML-Datei exportiert. Das urspriingliche Projekt wird dadurch 
nicht tiberschrieben, sondern verbleibt an der urspriinglichen Stelle im urspriinglichen Format. Wenn Sie den 
XML-Export unter Mac OS 8 oder 9 verwenden wollen, sollten Sie vorher die Speicherzuteilung an REALbasic erhGhen. 


XML laden 


Als XML-Dateien vorliegende Projekte k6nnen tiber den Meniipunkt Ablage/Offnen (Windows: Datei/Offnen) impor- 
tiert werden. Im Dateidialog werden zwar sdmtliche Textdateien angezeigt, es konnen aber nur korrekt formatierte 
XML-Dateien gedffnet werden. Wenn das Einlesen erfolgreich war, wird ein neues Projekt unter dem Namen der 
XML-Datei mit angehangtem ,,(Konvertiert)“ erzeugt. 


Hinweis: Wenn Sie eine XML-Datei aus einem AppleScript heraus 6ffnen wollen, k6nnen Sie dieselbe Syntax wie bei nor- 
malen Projektdateien verwenden, also: ,,tell application "REALbasic" to open someFile*. 


Projekt-Vorlagen 


Wenn Sie bestimmte Elemente in mehreren Projekten verwenden wollen, empfiehlt es sich, ein neues Projekt zu erzeu- 
gen, die Elemente hinzufiigen und dann das Projekt als Vorlage zu speichern. Wenn Sie spater auf Basis dieser Vorlage 
ein neues Projekt beginnen, erzeugt REALbasic automatisch ein neues, unbenanntes Projekt, das die Elemente der Vor- 
lage bereits enthdlt. Die Vorlage bleibt dabei unverandert. 


Am bequemsten gestaltet sich die Arbeit mit Vorlagen, wenn Sie sie im Verzeichnis ,,Project Templates“ ablegen, das sich 
im REALbasic-Verzeichnis befindet. Ihre Vorlagen erscheinen dann in der Vorlagenliste, die bei Auswahl des Menitipunkts 
Ablage/Neu (Windows: Datei/Neu) angezeigt wird. 
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kates Das Benutzer-Interface 


Das Benutzer-Interface ist gewissermafsen das Aushangeschild Ihres Programms. Wenn es klar strukturiert ist und sich an 
die Konventionen des Betriebssystems halt, werden die Anwender auch gut mit Ihrem Programm zurecht kommen. 
REALbasic bietet einfache Hilfsmittel, um eine Benutzerschnittstelle schnell und effizient zu entwerfen. Der eingebaute 
Interface Assistant™ hilft Ihnen, ein sauber standardisiertes Interface aufzubauen. 

In diesem Kapitel werden Sie alles lernen, was Sie dazu wissen miissen. Sie lernen die Elemente der Benutzerschnitt- 
stelle kennen und werden mit einigen Richtlinien vertraut gemacht, an die man sich halten sollte, wenn man Mentis und 
Fenster entwirft. 


Inhalt 


Arbeiten mit Fenstern 

Interaktion durch Steuerelemente 
Meniis hinzuftigen 

Richtlinien fiir Benutzeroberflachen 


Arbeiten mit Fenstern 


Normalerweise befindet sich der grdfte Teil des Benutzer-Interface in Fenstern des Anwendungsprogramms, manche 
Programme bendtigen aber auch gar keine Fenster. Sie gestalten das Benutzer-Interface, indem Sie die benotigten Fens- 
ter anlegen und dann Steuerelemente wie PushButtons und Checkboxes hinzuftigen. Sie konnen auch eine Bilddatei 
vom Desktop direkt auf ein Fenster ziehen, das Bild wird dann als Fensterhintergrund verwendet. 


Per Voreinstellungen besitzt eine REALbasic Desktop-Applikation ein Fenster, das angezeigt wird, sobald die Applikation 
lauft. Normalerweise beginnt man damit, das GUI zu entwerfen, indem man Elemente in diesem Fenster anordnet und 
schreibt dann die benotigten Methoden. 


Um einer Applikation weitere Fenster hinzuzuftigen, gehen Sie wie folgt vor: 


© Erzeugen Sie ein neues Fenster mit dem Mentipunkt Ablage/Neues Fenster (Windows: Datei/Neues Fenster). 

© Legen Sie in der Eigenschaften-Palette den Typ und andere Eigenschaften des Fensters fest. 

© Versehen Sie das Fenster mit Steuerelementen, indem Sie diese aus der Steuerelementepalette auf das Fenster zie- 
hen. 

@ Schreiben Sie — wo notwenig — den bendtigten Quelltext. 

e Zeigen Sie das Fenster an (siehe ,,Fenster ffnen“ auf Seite 204). 


Im folgenden Abschnitt gehen wir auf die elf Fenstertypen ein, die von REALbasic unterstiitzt werden. Zusatzlich, zu die- 
sen Fenstertypen, konnen Sie Dialoge anzeigen, ohne explizit ein Fenster daftir zu erzeugen. Verwenden Sie daftir die 
MessageDialog Klasse, die auch in diesem Dokument beschrieben ist. 


Fenstertypen 


REALbasic kennt elf verschiedene Fenstertypen. Einige werden in modernen Anwendungen jedoch nur sehr selten ein- 
gesetzt und sind hauptsdchlich aus historischen Griinden vorhanden. Andere werden nur von Mac OS X unterstiitzt. Es 
folgt eine Liste der Fenstertypen: 
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fos} 
co 


Dokumentfenster 

bewegliche modale Fenster 

modale Dialoge 

schwimmende Fenster 

einfache Boxen 

schattierte Boxen 

abgerundete Fenster (nicht unter Mac OS X) 

globale schwimmende Fenster 

Sheet-Fenster (nur unter Mac OS X) 

Metallfenster (nur unter Mac OS X 10.2 und hGher) 
Schubladenfenster (nur unter Mac OS X 10.2 und hoher) 
Der spatere Einsatzzweck entscheidet dariiber, welchen Typ Sie wahlen. Jeder Fenstertyp hat sein eigenes Icon im Pro- 
jektfenster. Dies zeigt die folgende Abbildung: 


Abb. 14: Projektfenster mit den 11 verschiedenen Standardfenstertypen 
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Dokumentfenster 


Dokumentfenster sind der am haufigsten verwendete Fenstertyp. Der Benutzer kann Dokumentfenster gedffnet lassen 
und andere Fenster in den Vordergrund holen etc. Dokumentfenster k6nnen mit dem SchlieSknopf (falls vorhanden) 
oder einem entsprechend programmierten PushButton geschlossen werden. 


Abb. 15: Ein Dokumentfenster 


e0 Dokumentfenster 


5 Doramenitenster a DORI 


Dokumentfenster konnen einen SchlieSknopf, einen Zoomknopf und eine Angreifecke (mit der die Fenstergr68e verin- 
dert werden kann) haben. Unter Mac OS X besitzen die Fenster einen roten, griinen und gelben Knopf in der Titelleiste. 


Wenn Sie Ihrem Projekt ein neues Fenster tiber Datei/Neues Fenster hinzufiigen, ist es vom Typ Dokumentfenster. Sie 
k6nnen den Typ tiber die Frame-Eigenschaft in der Eigenschaften-Palette andern. 


Wenn Sie REALbasic zum ersten Mal starten, enthalt das voreingestellte Projekt ein leeres Dokumentfenster. 
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Bewegliche modale Fenster 


Dieser Fenstertyp bleibt im Vordergrund und blockiert die Eingabe in andere Fenster des Programms. Man bezeichnet 
diesen Zustand als modal, da das Programm in einem Modus ist, in dem nur weitergearbeitet werden kann, nachdem das 
modale Fenster geschlossen wurde. Immer dann, wenn es unbedingt notig ist, dass der Benutzer eine Entscheidung 
trifft, ohne die das Programm seine Arbeit nicht sinnvoll fortsetzen kann, muss ein modales Fenster verwendet werden. 
Da es beweglich ist, kann der Benutzer Informationen in dahinter liegenden Fenstern nach wie vor einsehen. 


Abb. 16: Ein bewegliches modales Fenster 


Beweglich, modal 


@ Beweslich, modal [- [of xj Ol >. Beweniicher monaler palo 2 \-)\4)\x) Beweglich, modal 


Bewegliche modale Fenster konnen auf dem Macintosh nicht einfach geschlossen werden, da sie eine Eingabe des 
Benutzers erwarten. Daher verftigen sie nicht tiber einen SchlieSknopf. Sie miissen einen entsprechenden Knopf im 
Fenster vorsehen, es sei denn, das Fenster schlief&t sich von selbst, nachdem ein bestimmter Vorgang abgeschlossen ist. 
Solche Fenster auf dem Macintosh k6nnen in der Gr6fe nicht verindert werden und haben keine Zoombox. Sie miissen 
daher die Grofe des Fensters selbst festlegen. 


Unter Windows und Linux besitzt ein bewegliches modales Fenster einen Minimieren-, Maximieren- und Schliefsknopf in 
der Titelleiste. Bei MDI-Interfaces 6ffnet sich das Fenster in der Mitte des Bildschirms und nicht in der Mitte des 
MDI-Fensters. Daher kann es passieren, dass sich das bewegliche modale Fenster auerhalb des MDI-Fensters 6ffnet. 


Hinweis: Es gibt einen Ausnahmefall, in dem ein bewegliches modales Fenster nicht das oberste Fenster ist. Dies ist der 
Fall, wenn gleichzeitig ein schwimmendes Fenster ge6ffnet wird. Es ist allerdings schlechter Programmierstil, dies zu tun, 
denn ein modales Fenster wird ja gerade dann eingesetzt, wenn der Benutzer nichts anderes machen darf. 


Modale Dialoge 


Diese Fenster sind den beweglichen modalen Fenstern sehr ahnlich. Der einzige Unterschied ist, dass modale Dialoge 
keine Titelleiste haben, so dass sie nicht bewegt werden konnen. Unter Windows hat eine modale Dialogbox keinen 
Minimieren-, Maximieren- oder SchlieSen-Knopf. In Windows-MDI-Applikationen 6ffnet sich ein modaler Dialog in der 
Mitte des Bildschirms und nicht in der Mitte des MDI-Fensters. Daher kann es passieren, dass sich die modale Dialogbox 
auferhalb des MDI-Fensters 6ffnet. Unter Linux besitzt ein modaler Dialog eine Titelleiste, einen SchlieSen- und Mini- 
mieren-Button. Die Dialogbox fiir das Seitenformat ist ein Beispiel fiir einen solchen modalen Dialog. 


Abb. 17: Ein modaler Dialog 


i] Mottater pyalony 


d 


Anmerkung: Die fiir bewegliche modale Fenster aufgeftihrte Ausnahme gilt auch fiir modale Dialoge. 


Schwimmende Fenster 


Ein schwimmendes Fenster (floating Window oder auch Windoid) schwimmt oben, ahnlich wie die modalen Fenster. Im 
Unterschied zu diesen bleiben andere Fenster voll bedienbar, auch wenn sie im Hintergrund sind. Wenn Sie mehrere 
schwimmende Fenster haben, dann kénnen Sie eines dieser Fenster in den Vordergrund holen, aber alle nicht-schwim- 
menden Fenster bleiben im Hintergrund. Da die schwimmenden Fenster immer oben liegen, sollten sie méglichst klein 
sein, da sie dem Benutzer sonst im Weg sind. Daher werden diese Fenster meistens ftir Werkzeugfenster etc. verwendet. 
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Ein globales schwimmendes Fenster ist ein schwimmendes Fenster, das in der obersten Ebene einer bestimmten Appli- 
kation oder in der obersten Ebene der Fenster aller laufenden Applikationen liegt. 


Abb. 18: Ein schwimmendes Fenster 


a ‘Schwimmendes Fenster E) 


\v) Schwmmmentes Fenster, Ene is} Schwimmendes Fenster 


Wie Dokumentfenster konnen schwimmende Fenster einen SchlieSknopf haben. Sie kGnnen auch vom Benutzer in der 
Gr6f8e verindert werden, sie haben jedoch nie eine Zoombox. 


In Windows-MDI-Applikationen kann ein schwimmendes Fenster aus dem Fenster der Applikation hinausschwimmen. 
Normalerweise 6ffnet sich ein schwimmendes Fenster in einer Windows-MDI-Applikation in der linken oberen Ecke des 
Bildschirms, egal wo sich das MDI-Fenster befindet. 


Einfache Box 


Diese Fenster funktionieren wie modale Dialogfenster. Der einzige Unterschied liegt in ihrem Aussehen. Solche Fenster 
werden nur dann benotigt, wenn eine Anwendung den Desktop tiberdecken soll. AuSerdem werden sie fiir 
About-Boxen verwendet. 


Abb. 19: Eine einfache Box 


», SEanfache Box, 


In Windows-MDI-Applikationen 6ffnen sich einfache Boxen in der Mitte des Bildschirms und nicht in der Mitte des 
MDl-Fensters. Daher kann es passieren, dass sich die einfache Box auSerhalb des MDI-Fensters 6ffnet. 


Schattierte Box 


Diese Fenster funktionieren wie eine einfache Box. Der einzige Unterschied liegt in ihrem Aussehen. Solche Fenster wer- 
den meist fiir About-Boxen verwendet. 


Abb. 20: Schattierte Box 


Ss Selatiene Box: 


In Windows-MDI-Applikationen 6ffnen sich schattierte Boxen in der Mitte des Bildschirms und nicht in der Mitte des 
MDl-Fensters. Daher kann es passieren, dass sich die schattierte Box aufserhalb des MDI-Fensters 6ffnet. 


Unter Mac OS X funktioniert eine schattierte Box wie ein modaler Dialog mit einem Minimieren-Knopf. 


Abgerundete Fenster 


Abgerundete Fenster sind Dokumentfenster, die etwas anders aussehen. Sie k6nnen auf dem Macintosh nicht in der 
Gr6fe verandert werden und haben auch keine Zoombox. Unter Windows hat ein abgerundetes Fenster die Stan- 
dard-Knopfe fiir Minimieren, Maximieren und Schlie&en in der Titelleiste und die Ecken sind nicht abgerundet. Sie wer- 
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den eigentlich nicht mehr verwendet und es gibt auch keinen Grund, sie einem Dokumentfenster vorzuziehen. Sie sind 
mehr oder weniger ein Uberbleibsel aus alten Tagen des Mac OS. Abgerundete Fenster werden in Mac OS X Applikatio- 
nen als Dokumentfenster angezeigt. 


Abb. 21: Ein abgerundetes Fenster 


Abgerundetes Fenster @Abserundetes Fenster Eiolx) AbMerINIPteS Fenster, \_ ia) x) e0c9e Abgerundetes Fenster 


Global schwimmendes Fenster 

Ein global schwimmendes Fenster sieht wie ein schwimmendes Fenster aus, mit der Ausnahme, dass es in der Lage ist, 
iiber den Fenstern anderer Applikationen zu schwimmen, auch wenn Sie ein Fenster einer anderen Applikation nach 
vorne bringen. In folgender Abbildung wurde auf ein FrameMaker-Fenster mit diesem Text hier geklickt und trotzdem 
befindet sich das globale schwimmende Fenster dartiber. 


Abb. 22: Ein globales schwimmendes Fenster iiber einem Textdokument 


Bin global schwimmendes Fenster sieht wie ein schwimmendes Fenster aus, mit der Ausnahme, dafi es 
in der Lage ist, Uberjgitpseeteetse cased eee steel ota ¢spwimmen, auch wenn Sie ein Fenster 
einer anderen Appli 


fl . ; . Ich bin wichtiger als der FrameMaker! . 
Hinweis: Die Windo cID, die es Ihnen erlaubt, benutzerde- 


finierte Fenster-Typ len mehr Moéglichkeiten, als in diesem: 
‘Abschnitt beschrieb er-Typen werden jedoch nur auf dem’ 
Macintosh untersttitzt. Alle Fenster-Typen, die in diesem Abschnitt besprochen werden, funktionieren 
auf beiden Plattformen. Weitere Informationen finden Sie bgi der Behandlung der MacProcID-Eigen- 
schaft der Window-Klasse in der Sprachreferenz.{ 


Dies funktioniert nicht mit einem schwimmenden Fenster. Ein ,normales“ schwimmendes Fenster schwimmt nur tiber 
den Fenstern der Applikation, die es geffnet hat. 


Abb. 23: Globale schwimmende Fenster 


a Global schwimmendes Fenster | 


In Windows-MDI-Applikationen kann ein global schwimmendes Fenster aus dem MDI-Fenster hinausschwimmen. Es off- 
net sich normalerweise in der linken oberen Ecke des Bildschirms. 


Sheet-Fenster 


Sheet-Fenster ist der offizielle Name der herabgleitenden Fenster, die mit Mac OS X eingeftihrt wurden. Sie werden an 
Stelle der tiberholten modalen Dialoge verwendet. 


Abb. 24: Sheet-Fenster 


. sheetFenster 


Mochten Sie die Anderungen am Dokument vor 
dem SchlieRen sichern? — 


Wenn Sie nicht sichern, gehen Ihre Anderungen verloren. 


(Nicht sichern \_Abbrechen ) €sichern 
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Sheet-Fenster verhalten sich genauso wie modale Dialoge. Der einzige Unterschied besteht darin, dass per Animation 
der Eindruck erweckt wird, als ob das Sheet-Fenster der Titelleiste des Ursprungsfensters entspringt. Es kann nicht ver- 
schoben werden und versetzt die Benutzeroberflache in einen modalen Zustand. Der Benutzer ist gezwungen, auf die 
Frage im Sheet-Fenster zu reagieren. 

Sheet-Fenster verhalten sich nur unter Mac OS X wie Sheet-Fenster. Unter Windows und Linux verhalten sich Sheet-Fens- 
ter wie bewegliche modale Dialogfenster und unter Mac OS Classic wie modale Dialoge. 


Abb. 25: Sheet-Fenster unter Windows XP 


A Anderungen in dokument speichern? 


{ Ja ] Nein Abbrechen 


Metallfenster 


Ein Metallfenster verwendet den Metall-Look des Mac OS X 10.3-Finders und der iApps von Apple. Ein Metallfenster hat 
eine Angreifecke zur Gréendnderung und die Standard-Titelleiste eines Dokumentfensters mit Kndpfen zum Schlie- 
Sen, Minimieren und Maximieren. Metallfenster tauchen nur unter Mac OS X 1.2 und hoher auf. 


Abb. 26: Metallfenster 


| ane Namenlos 


Unter Windows und Mac OS 8/9 wird ein Metallfenster als normales Dokumentfenster dargestellt. 


Schubladenfenster 


Schubladenfenster wurden auf dem Mac mit Mac OS X 10.2 eingeftihrt. Sie konnen oben, unten oder seitlich eine Schub- 
lade ausfahren, in der zusatzliche Informationen angezeigt werden. Apple Mail beispielsweise verwendet ein Schubla- 
denfenster zur Anzeige der Mailboxen. 


Unter Windows wird ein Schubladenfenster als separates schwimmendes Fenster dargestellt. 
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Abb. 27: Schubladenfenster bei Mail 
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= e—— Schubladenfenster 


Um ein Schubladenfenster anzuzeigen, verwenden Sie die ShowWithin-Methode der Window-Klasse. Damit definieren 
Sie das Elternfenster, zu dem das Schubladenfenster gehdrt und legen anschliefsend fest, aus welcher Seite das Fenster 
herausfahren soll (links, rechts, oben, unten oder gemaf der System-Voreinstellungen. Bei der letzten Option entschei- 
det das Betriebssystem, wo sich das Schubladenfenster am besten ausfahren lasst.) 


Benutzerdefinierte Fenstertypen 


Die Window-Klasse hat eine Eigenschaft namens MacProclD, mit der benutzerdefinierte Fenster-Typen erzeugt werden 
konnen. Diese Eigenschaft bietet Innen mehr Méglichkeiten, als die in diesem Abschnitt beschriebenen. Benutzerdefi- 
nierte Fenster-Typen werden jedoch nur auf dem Macintosh unterstiitzt. Alle Fenster-Typen, die in diesem Abschnitt 
besprochen werden, funktionieren auf allen Plattformen mit den im jeweiligen Abschnitt erwahnten Ausnahmen. Wei- 
tere Informationen finden Sie bei der Behandlung der MacProcID-Eigenschaft der Window-Klasse in der Sprachreferenz. 


Die Fenstereigenschaften eines Fensters verwenden 


Wenn Sie im Projektfenster auf den Namen des Fenster klicken, stellt das Eigenschaftenfenster die Eigenschaften dieses 
Fensters dar, die in der Entwicklungsumgebung gesetzt werden kénnen (im Gegensatz zu den Eigenschaften, die im 
Code gesetzt werden kdnnen). Folgende Abbildung zeigt ein im Projektfenster ausgewahltes Fenster und seine Eigen- 
schaften. 


Abb. 28: Ein beweglicher modaler Dialog im Projektfenster und seine Eigenschaften 


@ © © TextEditor-Kapitel11 is) Eigenschaften 
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Height: 140 
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Frame: 0-Dokumentfenster w 
HasBackColor: 0 
BackColor: 
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Title: Finden und Ersetzen 
Visible 
FullScreen: [} 
MenuBarVisible [¥f 
CloseBox: 
Growicon: [) 
Zoomicon: [~] 
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Sie konnen die Eigenschaften eines Fensters andern, indem Sie Werte in die Bereiche im Eigenschaftenfenster eintragen, 
in denen Eingaben méglich sind, Mentipunkte auswahlen oder Checkboxen an- oder ausklicken. 


Wenn Sie in ein Eingabefeld Werte eingeben, tibernehmen Sie den Wert mit der Return-Taste. In folgendem Beispiel 
wurde der Fenstertitel von der Vorgabe ,,Namenlos“ in ,,Finden und Ersetzen“ gedndert. Der Text der Title-Eigenschaft 
erscheint in der Titelzeile des Fensters, wenn das Fenster dargestellt wird. Folgende Abbildung zeigt das Fenster der fer- 
tigen Applikation. 


Abb. 29: Der Wert der Title-Eigenschaft in der fertigen Applikation 


‘e0 Finden und Ersetzen 


fFinden | Ersetzen | 


Suche nach: Basic 


(Abbrechen)) finden») 


Im Eigenschaftenfenster werden Drop-Down-Mentis durch ein Dreieck markiert. Im Beispiel wird die Frame-Eigenschaft 
tiber das Drop-Down-Menii des Dokumentfensters auf beweglicher modaler Dialog geandert. 


Abb. 30: Andern der Frame-Eigenschaft 
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=" : 
Das Icon © (oder [EJ unter Windows/Mac OS Classic) zeigt an, dass nach einem Klick darauf ein Texteingabedialog 
erscheint. Im obigen Beispiel befindet sich bei der BalloonHelp-Eigenschaft ein solches Icon. Sie konnen den Hilfetext 
direkt in den Eingabebereich bei BalloonHelp eingeben oder durch Klick auf © einen gréfSeren Texteingabebereich 
aufrufen, wie er in folgender Abbildung gezeigt wird. 


Abb. 31: Hilfetext im ,,Wert bearbeiten”-Bereich eingeben 


Wert bearbeiten 


Verwenden Sie dieses Fenster, um nach Text zu 
suchen oder diesen zu ersetzen| 
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Fenster erzeugen 


Wenn Sie ein neues Desktop-Applikation-Projekt beginnen, erzeugt REALbasic automatisch ein neues Fenster namens 
Fensterl. Es gibt zwei Moglichkeiten, Ihrem Projekt ein weiteres Fenster hinzuzuftigen. Sie konnen einen Befehl aus der 
Meniileiste wahlen oder das Kontextmenii des Projektfensters aufrufen. 


Um mittels des Meniibefehls ein neues Fenster anzulegen, klicken Sie auf Ablage/Neues Fenster (Windows: Datei/ 
Neues Fenster). Das Kontextmeniti erhalten Sie, indem Sie einen ctrl-Klick (Windows: Rechtsklick) auf das Projektfens- 
ter ausftihren. Wahlen Sie dann Neu/Neues Fenster. 


Abb. 32: Neues Fenster iiber das Kontextmenii des Projektfensters hinzufiigen 
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Fenster, die Sie anlegen, dienen als Vorlagen. Offnet Ihr Programm ein Fenster, dann wird eine Kopie dieser Vorlage 
erzeugt. Daher kann Ihr Programm mehrere Kopien des gleichen Fensters zur gleichen Zeit 6ffnen. Es ist wichtig, dass 
man diesen Sachverhalt versteht, denn aus ihm folgt, dass man nicht zwei gleiche Fenster entwerfen muss, wenn das 
Programm spater zwei Fenster dieser Art 6ffnen soll. 


In der Tutorial-Applikation von REALbasic verwendet die Textverarbeitung eine Fenstervorlage als Dokumentfenster. Mit 
dem Mentipunkt Datei/Neu kann der Benutzer in der fertigen Anwendung aus der einen Vorlage beliebig viele Doku- 
mentfenster erzeugen. Die Tutorial-Applikation benGtigt zusatzliche Fenster fiir den ,Suchen und Ersetzen“-Dialog. 


Fenster entfernen 


Um ein Fenster aus einem Projekt zu entfernen, klicken Sie im Projektfenster auf den Namen des Fensters und driicken 
die Backspace-Taste oder wahlen Sie Bearbeiten/Léschen. Sie k6nnen auch mit gedriickter ctrl-Taste (Windows: 
Rechtsklick) auf den Fensternamen klicken und im Kontextmenti den Befeh] Léschen aufrufen. 


Abb. 33: Ein Fenster tiber das Kontextmenii entfernen 
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Bearbeiten 
Sperren... 
Sie kénnen viele Aktionen in REALbasic riickgangig machen. Mit Bearbeiten/Undo (s8-Z auf dem Mac, Strg und Z unter 


Windows) konnen Sie z.B. ein versehentlich geléschtes Fenster wiederherstellen. 


Vorgabefenster festlegen 


Normalerweise wird das standardmafsig im Projekt vorhandene Fenster automatisch gedffnet, wenn die Applikation 
gestartet wird. Dieses Fenster wird auch als Vorgabefenster bezeichnet. Falls es in Ihrem Projekt mehrere Fenster gibt, 
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wollen Sie vielleicht, dass sich standardmafsig ein anderes oder gar kein Fenster automatisch 6ffnet. Dies konnen Sie 
tiber den Mentipunkt Bearbeiten/Projekteinstellungen festlegen. Gehen Sie dazu folgendermafen vor: 


1. Rufen Sie den Mentipunkt Bearbeiten/Projekteinstellungen auf. Es 6ffnet sich der Dialog ,,Projekteinstellungen*. 


Abb. 34: Der Projekteinstellungen-Dialog 


Projekteinstellungen 
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2. Wahlen Sie unter Vorgabefenster das gewiinschte Fenster aus oder ,keins“, falls die Applikation kein Fenster 6ffnen 
soll. 

3. Betdtigen Sie den OK-Knopf, um die Auswahl zu tibernehmen. 

Wenn Sie Ihre Applikation starten, wird standardmafig das ausgewahlte Fenster (oder keines) ge6ffnet. 


Fenster verschliisseln 


Sie konnen ein Fenster im Projektfenster verschliisseln (schiitzen) oder entschliisseln (freigeben). Ein gesperrtes Fens- 

ter kann nicht im Fenster-Editor angezeigt werden. Niemand kann auf den Quelltext eines verschliisselten Fensters und 

seiner Steuerelemente zugreifen. 

Beim Verschliisseln mtissen Sie ein Passwort festlegen, das spater wieder zum Entschltisseln verwendet werden kann. In 

diesem Zusammenhang k6nnen Sie auch die Checkbox V3.0 Verschliisselung oder hoher verw. deaktivieren, wenn 

Sie die Riickwartskompatibilitat zu friiheren REALbasic Versionen garantieren wollen. 

1. Um ein Fenster zu verschliisseln, selektieren Sie es im Projektfenster und wahlen den Mentipunkt Bearbeiten/ 
Verschliisseln. Alternativ konnen Sie im Projektfenster einen ctrl-Klick (Windows: Rechtsklick) auf den Fensterna- 
men ausftihren und im Kontextmeniti den Mentipunkt Verschlisseln aufrufen. Es erscheint folgender Dialog: 


Abb. 35: Der Verschliisseln-Dialog 


FindenFenster verschlisseln 


Pawort: eeeeee 


Bestatigen: = eeeees| 
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2. Geben Sie ein Passwort fiir die Verschliisselung ein und bestatigen Sie dieses. 


3. Selektieren Sie V3.0 Verschliisselung oder hoher verw. nur, wenn das Fenster mit REALbasic Version 3 oder héher 
verwendet wird. Wenn Sie diese Option nicht anwahlen, wird der Algorithmus von Version 2.1 verwendet. 


Wichtig: Vergessen Sie nicht ihr Passwort. 


Ein gesperrtes Fenster erscheint im Projektfenster mit einem Schliissel im Fenstersymbol. In folgender Abbildung wurde 
der Dialog FindenFenster verschliisselt. 
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Abb. 36: Verschliisseltes FindenFenster im Projektfenster 
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Hinweis: Das Symbol kennzeichnet ein verschltisseltes, bewegliches, modales Fenster. Jeder Fenstertyp hat ein eigenes 
Symbol. 


Wenn ein Anwender versucht, ein verschliisseltes Fenster im Fenster-Editor zu 6ffnen, erscheint folgende Warnbox: 


Abb. 37: Hinweis bei verschliisselten Objekten 


1 Dieses Objekt wurde vom Autor 
verschlusselt - es kann nicht 


gedffnet werden 


Wenn Sie das Fenster und den dazu gehdrenden Quelltext bearbeiten wollen, mtissen Sie es zundchst entschliisseln: 


1. Selektieren Sie das Fenster im Projektfenster und wahlen den Mentipunkt Bearbeiten/Entschlisseln. Alternativ 
konnen Sie im Projektfenster einen ctrl-Klick (Windows: Rechtsklick) auf den Fensternamen ausftihren und im Kon- 
textmenti den Mentipunkt Entschliisseln aufrufen. Es erscheint der Entschliisseln-Dialog. 


Abb. 38: Der Entschliisseln-Dialog 
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2. Geben Sie das Passwort ein und klicken Sie auf Entschliisseln. Nach kurzer Zeit verschwindet der Schliissel aus dem 
Icon des Fensters, um anzuzeigen, dass die Entschliisselung erfolgreich war. Wenn Sie ein falsches Passwort eingege- 
ben haben, informiert Sie eine entsprechende Dialogbox dariiber. Wenn Sie das Passwort nicht kennen oder verges- 
sen haben, gibt es keine Méglichkeit, das Fenster zu entschliisseln. 


Einfache Mitteilungsboxen 


In REALbasic gibt es auch einen einfachen Weg, Dialogboxen anzuzeigen, ohne dazu ein Fenster erzeugen und mit Steu- 
erelementen versehen zu miissen. Allerdings ist der Gestaltungsspielraum dabei stark eingeschrinkt: Bei den Mittei- 
lungsboxen handelt es sich um Fenster mit einem Symbol, etwas Text und einem oder mehreren Knépfen. Die einzige 
Interaktionsméglichkeit ist das Betatigen eines Knopfes. 


Zum Erzeugen dieser Boxen gibt es die MsgBox-Funktion und die MessageDialog-Klasse. 


Die MsgBox Funktion 


Verwenden Sie die MsgBox-Funktion, wenn Sie eine Meldung in einem modalen Dialog anzeigen méchten. Geben Sie 
beim Aufruf einfach den anzuzeigenden Text an. Die folgende Meldung k6nnte angezeigt werden, wenn ein 
Datei-Upload abgeschlossen ist. 

MsgBox “Dateitransfer abgeschlossen” 


Mit dieser Zeile wird ein Dialog angezeigt, der einen Knopf enthalt, mit dem der Benutzer die Meldung bestatigen kann. 
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Abb. 39: MsgBox unter Mac OS X 


Dateitransfer abgeschlossen! 
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Die MsgBox-Funktion besitzt zwei optionale Parameter, mit denen Sie den Dialog leicht abandern konnen. So kénnen 
Sie die Anzahl der angezeigten Buttons angeben, den Standard-Button bestimmen und auch ein Icon angeben. 

Wenn Sie die optionalen Parameter verwenden, wird MsgBox immer den Index des gedriickten Buttons zurtickgeben. 
Wenn Sie also mehr als einen Button anzeigen, miissen Sie den Riickgabewert auswerten. 


Die MessageDialog Klasse 


Verwenden Sie die MessageDialog Klasse, wenn Sie komplexere Dialoge gestalten wollen. Mit der MessageDialog Klasse 
k6nnen Sie Dialoge erzeugen, die bis zu drei Buttons enthalten und deren Beschriftung und Funktion bestimmen. 
Zusatzlich k6nnen Sie einen erklarenden Text anzeigen. 

Da MessageDialog eine Klasse ist, kGnnen Sie dies nicht mit einer Quelltextzeile erreichen. Sie miissen eine Variable 
deklarieren, instanziieren, deren Eigenschaften setzen und den Riickgabewert auswerten, der Ihnen mitteilt, welcher 
Button gedriickt wurde. 


Ein MessageDialog kann drei Buttons besitzen: ActionButton, CancelButton und AlternateActionButton. Diese besitzen 
folgende Eigenschaften: 


Eigenschaft | Beschreibung 


Caption Die Beschriftung des Knopfes. 
Visible Auf True setzen, um den Knopf anzuzeigen. 
Default Auf True setzen, um den Knopf als Standardknopf zu hervorzuheben. Standardmassig ist diese 


Eigenschaft fir die Klasse ActionButton auf True gesetzt. 


Cancel Auf True setzen, damit dieser Knopf auf das Driicken der Esc-Taste reagiert. Unter Mac OS reagiert dieser 
ebenso auf das Drticken von $8-,,.". Diese Eigenschaft kann nur fiir einen Knopf auf True gesetzt sein. 
Einige Betriebssysteme erlauben nicht, dass der Cancel-Knopf gleichzeitig Standardknopf ist. 


Per Voreinstellung wird nur der Standardknopf angezeigt. Sie konnen die anderen Kn6pfe anzeigen, indem Sie deren 
Visible-Eigenschaft auf True setzen. 


Jetzt miissen Sie nur noch den anzuzeigenden Text und das Symbol festlegen (Hinweis, Achtung, Stopp, Frage). 


Wenn der Benutzer einen Knopf anklickt, wird ein MessageDialogButton-Objekt zurtickgegeben. Dieses kann vom Typ 
AcceptButton, CancelButton oder AlternateActionButton sein. Anhand dieses Typs kénnen Sie feststellen, welchen 
Knopf der Anwender angeklickt hat. 


In der Online-Sprachreferenz finden Sie weitere Informationen und Beispiele. 


Benutzerinteraktion Uber Steuerelemente 


Informationen, die Ihr Programm vom Benutzer entgegennehmen soll, erhalt es durch Steuerelemente. Dazu k6nnen 
die vordefinierten Steuerelemente von REALbasic verwendet werden. Es ist aber auch méglich, eigene Steuerelemente 
zu entwerfen. Die eingebauten Steuerelemente sind in der Steuerelementepalette zusammengefasst. 
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Abb. 40: Die Steuerelementepalette 


(s) € 5 


Separator-Steuerelement Linie-Steuerelement a: StaticText-Steuerelement 
CD) Oval-Steuerelement Rechteck mit runden Ecken [| Rechteck 
Placard-Steuerelement ImageWell-Steuerelement pe | Canvas-Steuerelement 
> PopupArrow-Steuerelement DisclosureTriangle-Steuerelement |) EditField-Steuerelement 
3 * Scrollbar-Steuerelement Scrollbar-Steuerelement © _ Slider-Steuerelement 
fy LittleArrows-Steuerelement BevelButton-Steuerelement (or) PushButton-Steuerelement 
Ww Popupmenu-Steuerelement ListBox-Steuerelement = 4 ListBox-Steuerelement 


Combo-Box-Steuerelement ) RadioButton-Steuerelement 
= 


= 5 Combo-Box-Steuerelement 

ChasingArrows-Steuerelement ProgressBar-Steuerelement 
= GroupBox-Steuerelement Rb3DSpace-Steuerelement = TabPanel-Steuerelement 
| SpriteSurface-Steuerelement SpriteSurface-Steuerelement Eu MoviePlayer-Steuerelement 
os OLEContainer-Steuerelement StandardToolbar-Objekt ? 7 Toolbar-Objekt 

DatabaseQuery-Steuerelement E io DataControl-Steuerelement 
Om NotePlayer-Steuerelement ContextualMenu-Steuerelement & Timer-Steuerelement 
&. Serial-Steuerelement RbScript-Steuerelement @ Socket-Steuerelement 
Py PowerPoint-Automatisierung Excel-Automatisierung Wy Word-Automatisierung 


Einige Steuerelemente sind spater ftir den Anwender sichtbar (z.B. PushButtons, ListBoxen), andere nicht. Indem Sie 
beispielsweise ein Socket-Steuerelement auf ein Fenster ziehen, erweitern Sie Ihre Applikation um Fahigkeiten zur Netz- 
werkkommunikation. Dem Fenster kann man das aber nicht ansehen. 


Im unteren Teil der Steuerelementepalette liegen die Steuerelemente zur Automatisierung der Microsoft Office-Pro- 
gramme PowerPoint, Excel und Word. Auch diese Steuerelemente enthalten keine ftir den Anwender sichtbaren Inter- 
face-Elemente. 

Wenn Sie eigene Steuerelemente entwickeln oder Steuerelemente von Drittanbietern installieren (auch ActiveX-Steuer- 
elemente), erscheinen diese unterhalb der Steuerelemente zur Office-Automatisierung. 


Steuerelemente anpassen 


Um ein Steuerelement Ihren eigenen Bediirfnissen anzupassen, erstellen Sie eine neue Klasse, die auf einem Standard- 
Steuerelement basiert und passen diese anschliefend Ihren Wiinschen an. Weitere Informationen zu diesem Thema fin- 
den Sie im Abschnitt ,Beispiele von Unterklassen“ auf Seite 306. 


Anordnen der Steuerelementepalette 


Der rechte Knopf in der Titelleiste der Steuerelementepalette schaltet die Anzeige der Palette zwischen horizontal und 
vertikal um. Folgende Abbildung zeigt beide Ausrichtungen: 
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Abb. 41: Horizontale und vertikale Palettenausrichtung 


Hier zum Umschalten klicken a Aa 
OU) 
ile 


'— Hier zum Umschalten klicken x] 


Unter Windows lduft die REALbasic IDE in einem sogenannten MDI-Fenster (Multiple Document Interface). Normaler- 
weise ist die Steuerelementepalette ein schwimmendes Fenster, das Sie auch aus dem MDI-Fenster herausziehen k6n- 
nen. Sie kénnen sie aber auch an eine der vier Seiten des MDI-Fensters andocken. Wahlen Sie dazu den Mentipunkt 
Fenster/Steuerelemente andocken und die gewiinschte Fensterseite aus. 


Steuerelemente verwenden 


Hinzufiigen 


Es gibt zwei Moglichkeiten, ein Steuerelement in ein Fenster zu integrieren. Entweder Sie verwenden die Steuerelemen- 
tepalette oder das Kontextmenii des Fensters, dem Sie das Steuerelement hinzuftigen wollen. 


Wenn Sie die Steuerelementepalette verwenden: 


1. Holen Sie das Fenster, auf dem das Steuerelement platziert werden soll, nach oben. Ist es nicht gedffnet, dffnen Sie es 
mit einem Doppelklick auf seinen Namen im Projektfenster. 


2. Ziehen Sie das gewiinschte Steuerelement aus der Steuerelementepalette auf das Fenster. 
Wenn Sie das Kontextmenti verwenden: 


1. Flihren Sie einen ctrl-Klick (Rechtsklick) in das entsprechende Fenster aus, um das Kontextmeniti aufzurufen. Der 
Eintrag Steuerelement hinzufiigen 6ffnet ein hierarchisches Untermenii. 


Abb. 42: Das Kontextmenii des Fenstereditors 


Wahle > 
Alles auswahlen 
Code bearbeiten (Fenster1) Lae. 
Steuerelement hinzufiigen \. > Standard > 
" Irgendeine > 
—_—_—_—_—_———— 


2. Verwenden Sie den Meniipunkt Steuerelement hinzufiigen/Standard, um das Steuerelement auszuwahlen, das 
Sie hinzuftigen mochten. Bei den hier aufgeftihrten Steuerelementen handelt es sich fast nur um sichtbare Steuerele- 
mente. Ausnahmen sind das Serial- und das Socket-Steuerelement. 
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Abb. 43: Hinzufiigen eines EditField-Steuerelements ber das Kontextmeniis des Fenstereditors 


AppleEventDescList 
AppleEventRecord 


Application... > 
Bounds3D 
Clipboard 
Collection 
ContextualMenu 
CriticalSection Line 
Database NotePlayer 
Database... > BevelButton 
SchlieBen DatabaseField Canvas 
Code bearbeiten DatabaseRecord ChasingArrows 
Wahle > Date CheckBox 
Dictionary DataControl 
Folderltem DisclosureTriangle 
FolderltemDialog... > 
Light3D GroupBox 
MDIWindow ImageWell 
Menultem... » Listbox 
Movie... > LittleArrows 
Object2D MoviePlayer 
Object2D... > Oval 
Object3D PagePanel 
Object3D... > PagePanel... > 
Picture Placard 


Das Steuerelement hinzufiigen/Beliebig-Untermenii fiihrt alle verfiigbaren Objekte auf. Wenn Sie ein Objekt auswah- 
len, das kein Steuerelement ist, wird es in der IDE durch ein generisches Icon reprasentiert. Durch Klick auf dieses Icon 
wahlen Sie es im Code-Editor des Fensters aus, als ob es ein sichtbares Steuerelement ware. 


Abb. 44: Icon fiir ein allgemeines Steuerelement 


& 


Seine Eigenschaften kGnnen Sie im Eigenschaftenfenster modifizieren — genauso wie bei einem Steuerelement. Falls das 
Objekt Events besitzt, konnen Sie diese im Code-Editor bearbeiten. 


Steuerelemente auswahlen 


Steuerelemente konnen auf drei Arten selektiert werden: Mit Mausklick, der Tabulatortaste oder tiber das Kontextmenii. 
Am einfachsten wahlen Sie ein Steuerelement aus, indem Sie darauf klicken. Das Kontextmenti enthilt zwei Moglichkei- 
ten, um ein Steuerelement auszuwahlen, Auswahlen und Alles auswahlen. Uber Alles auswahlen selektieren Sie alle 
Steuerelemente im Fenster. Im Auswahlen-Untermenii sind alle Steuerelemente aufgelistet, die sich im Fenster befin- 
den. Indem Sie auf einen Eintrag klicken, wahlen Sie das entsprechende Steuerelement aus. 


Abb. 45: Auswahl eines Steuerelements tiber das Kontextmenii des Fenstereditors 
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Ausschneiden 


Kopieren 
Léschen 

. 
Wahle > Fenster1 
Alles auswahlen ListBoxl =, 

= = PushButton 

Code bearbeiten (ListBox1) > PushButton2 
Steuerelement hinzufiigen >» 


Wenn Sie ein Steuerelement selektieren, zeichnet REALbasic einen Rahmen um das Steuerelement. 
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Abb. 46: Eine selektierte ListBox unter Mac OS X 


_ Theta 
_ Meridian 
_ Lexicon 
Sony 
Yamaha 
_ Pioneer | 


Sie k6nnen mit der Tabulatortaste von einem zum nachsten Steuerelement eines Fensters wechseln. Dabei kann man 
auch die Reihenfolge sehen, in der die Steuerelemente spater vom Benutzer angesprungen werden kénnen. Siehe auch 
,Andern der Steuerelementereihenfolge (Tab-Reihenfolge)* auf Seite 138. Indem Sie Shift-Tabulator driicken, werden 
die Steuerelemente in umgekehrter Reihenfolge angesteuert. Ist ein Steuerelement angewahlt, erscheinen Angreife- 
cken, mit denen die Grdfe des Elements geandert werden kann. Sollen mehrere Elemente ausgewahlt werden, mtissen 
sie mit gedriickter Shift-Taste mit der Maus angeklickt werden. Sie kGnnen auch einen Rahmen um eine Gruppe von 
Steuerelementen ziehen, um diese auszuwahlen. Unter Mac OS X werden alle ausgewahlten Steuerelemente von einer 
halbtransparenten Markierung umsdumt. 


Abb. 47: Auswahl zweier Steuerelemente mit Hilfe des Auswahlrechtecks 


e0ce8e Namenlos 


0 1 (Hinzufagen ) 


( Loschen 


Hinweis: Mit dem Mentipunkt Bearbeiten/Alles auswahlen kénnen Sie alle Steuerelemente im obersten Fenster auf 
einmal auswahlen. Nachdem alle ausgewahlt sind, kGnnen Sie mit Shift-Klick auf ein Steuerelement dieses einzelne aus 
der Auswahl entfernen. 


Unsichtbare Steuerelemente auswahlen 


Es ist méglich, dass ein Steuerelement von der Bildflache verschwindet, z.B. wenn Sie ihm einen negativen Wert bei der 
Left- oder Top-Eigenschaft zugewiesen haben (dann liegt es links neben oder tiber dem Fenster). Oder wenn Width und 
Height den Wert 0 haben, dann befindet sich das Steuerelement zwar weiterhin an der gleichen Stelle, ist aber nicht 
sichtbar. Um ein unsichtbares Steuerelement anzuwahlen, konnen Sie das Kontextmenii des Fensters verwenden. Das 
Auswahlen-Untermenii listet immer alle Steuerelemente auf, die zum Fenster gehoren, auch wenn diese nicht sichtbar 
sind. In der folgenden Abbildung wird ein EditField mit dem Wert 0 fiirWidth und Height auf diese Art und Weise ange- 
waht. Ist das Element ausgewahlt, erscheint ein Auswahlrahmen und seine Eigenschaften werden im Eigenschaftenfens- 
ter angezeigt. Sie konnen dann das Eigenschaftenfenster dazu verwenden, die Einstellungen ftir Position und Groe zu 
andern. 
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Abb. 48: Unsichtbare Steuerelemente auswahlen 
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SchlieRen 
Code bearbeiten 


Wahle > EditField1 
Hinzufiigen > _ 


Andern der Position eines Steuerelements 


Die Position eines Steuerelements kann man mit der Maus, mit den Pfeiltasten (um jeweils einen Pixel) oder iiber die 
Position-Eigenschaften im Eigenschaftenfenster andern. 


Abb. 49: Die Position-Eigenschaften eines PopupMenu-Steuerelements 


3) Eigenschaften 


Name: PopupMenul 


PopupMenu 


ControlOrder: 
Left: 81 

Top: 173 

Width: 80 
Height: 20 
LockLeft: 
LockTop 
LockRight: 
LockBottom: 


Die Left- und Top-Eigenschaften legen die Position der linken oberen Ecke des Steuerelements fest, wahrend die Width- 
und Height-Eigenschaften die Gréf&e definieren. Sie k6nnen diese Eigenschaften immer verwenden, um Position und 
Gr6fe eines Steuerelements priazise festzulegen. 

Wenn Sie ein Steuerelement draggen, kGnnen Sie es an anderen Objekten im Fenster ausrichten, indem Sie auf die auto- 
matisch erscheinenden vertikalen und horizontalen Hilfslinien achten. Wenn sich das Objekt, das Sie draggen, in Hohe 
der horizontalen oder vertikalen Kante eines anderen Objekts befindet, erscheinen voriibergehend Hilfslinien, die es 
erlauben, das Objekt prazise zu positionieren. Folgende Abbildung zeigt, wie man einen PushButton in Bezug auf die 
Grundlinien eines anderen PushButtons und den rechten Rand einer ListBox ausrichtet. 


Abb. 50: Ausrichten eines Steuerelements an den Hilfslinien: 
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Se Objekt, das bewegt wird. 
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Position eines Steuerelements mit der Lock-Eigenschaft festlegen 


Jedes sichtbare Steuerelement hat die vier boole’sche Eigenschaften LockLeft, LockRight, LockTop und LockBottom, die 
Sie verwenden konnen, um die horizontalen und vertikalen Kanten mit den zugeh6rigen Kanten des Fensters fest zu 
verbinden. Wenn eine dieser Eigenschaften eingeschaltet ist, bleibt der Abstand zwischen der Kante des Steuerelements 
und der zugeh6rigen Fensterkante immer gleich, wenn der Anwender die Grofse des Fensters dndert. 


Diese Eigenschaften werden verwendet, um REALbasic mitzuteilen, dass es die Steuerelemente skalieren oder bewegen 
muss, wenn der Anwender die Grose des Fensters andert. Wenn Sie z.B. ein MultiLine-EditField fiir ein Textverarbei- 
tungsfenster verwenden, wollen Sie die Kanten des Steuerelements mit den Kanten des Fensters gleichsetzen und set- 
zen daftir die Eigenschaften LockLeft, LockRight, LockTop und LockBottom, damit sich das Steuerelement automatisch 
anpasst, wenn der Anwender die Grdfe des Fensters andert. Folgende Abbildungen demonstrieren dies. 


Abb. 51: Ein MultiLine-EditField fir eine Textverarbeitung 


@ © @ _ Namenlos 


Folgende Abbildung zeigt, wie die vier Eigenschaften funktionieren. 


Abb. 52: Andern der GréBe des Fensters mit aktiven und inaktiven Lock-Eigenschaften 


e808 Namenlos eee Namenlos ; 

0 ) 
Lock-Eigenschaften ausgeschaltet. Das Lock-Eigenschaften eingeschaltet. Das 
EditField behalt seine GroBe und Posi- EditField wachst und schrumpft, wenn 
tion, wenn sich die FenstergroBe andert. sich die FenstergroBe andert. 


Im nachsten Beispiel sind nur die Eigenschaften LockRight und LockBottom gesetzt. Das EditField wandert nach unten 
und nach rechts, wenn das Fenster vergrofert wird. 
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Abb. 53: Andern der GréBe des Fensters, wenn LockLeft und LockTop nicht aktiv sind 


Nur die untere und eee Namenlos 
die rechte Seite des 

Steuerelements sind 

»gelockt”. 


Interessant wird es, wenn wir ein weiteres Steuerelement hinzuftigen. Sehen Sie folgende Abbildung: 


Abb. 54: Ein PushButton unter dem EditField 


@ © @ __ Namenios 


Der PushButton sollte nur die Eigenschaften LockRight und LockBottom aktiviert haben. Er soll seine relative Position 
zum EditField behalten. Er soll aber nicht seine Grofe andern, wenn sich die Gro&e des Fensters andert. Dies zeigt fol- 
gende Abbildung. 


Abb. 55: Effekt beim Andern der Fenstergr6Be, wenn ein PushButton ,,gelockt” ist 
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Der PushButton hat die Eigenschaften Der PushButton hat alle vier 

LockRight und LockBottom. Er behalt Form Lock-Eigenschaften gesetzt. Er behalt den 

und relative Position in Bezug auf das horizontalen und vertikalen Abstand zu den 

EditField. Fensterrandern und wachst somit mit dem 
Fenster. 


Ein ungewohnlicher Effekt tritt auf, wenn der Anwender das Fenster horizontal oder vertikal verkleinert und der Push- 
Button mit den beiden Kanten verbunden ist, die sich aufeinander zubewegen. In der folgenden Abbildung wird dies mit 
einem PushButton demonstriert, bei dem LockTop und LockBottom gesetzt sind. Da der PushButton den Abstand nach 
oben und unten beibehalten soll, sieht es so aus, als wiirde er beim Verkleinern des Fensters verschwinden. In folgender 
Bilderreihe versucht das Steuerelement seine Distanz nach oben und unten gleichzeitig zu bewahren, wahrend sich die 
Hohe des Fensters verringert. 
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Abb. 56: Effekt beim Reduzieren der Hohe eines Fensters auf ein Steuerelement, bei dem LockTop und LockBottom aktiv ist 


@ @ @ _ Namenios @ © @ _ Aamentos = 8 © @ _ Namenlos 
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Dies passiert, da es Platz tiber- und unterhalb des PushButtons gibt. Das EditField verschwindet dagegen nicht, da es kei- 
nen Platz zwischen dem oberen Rand des EditFields und dem oberen Rand des Fensters gibt. 


Andern der Eigenschaften eines Steuerelements 


Einige Anderungen am Verhalten von Steuerelementen miissen im Eigenschaftenfenster vorgenommen werden. Die 
Position des Elements ldsst sich zwar ganz einfach durch Ziehen mit der Maus andern, die meisten anderen Anderungen 
konnen aber nur im Eigenschaftenfenster eingegeben werden. 


Das Eigenschaftenfenster zeigt alle Eigenschaften des gerade selektierten Steuerelements, die innerhalb der Entwick- 
lungsumgebung geaindert werden konnen. Sind mehrere Elemente ausgewahlt, so werden nur die Eigenschaften 
gezeigt, die alle gewahlten Elemente gemeinsam haben. 


Einige Eigenschaften werden durch Tastatureingaben festgelegt, andere durch Aktivieren bzw. Deaktivieren von Check- 
boxen. Bei Eigenschaften, die durch eine Tastatureingabe gesetzt werden, konnen Sie den neuen Wert mit Enter oder 
Return bestatigen. Die Caption- oder Text-Eigenschaft einiger Steuerelemente kann bearbeitet werden, indem man das 
Steuerelement im Fenstereditor selektiert und den neuen Text im Eigenschaftenfenster eingibt. 


Abb. 57: Andern der Caption-Eigenschaft eines PushButtons 


is] Eigenschaften 


Name: PushButton1 
Index: 
Super: PushButton Vv 
Position | 
ControlOrder: 2 
Left: 155 
Top: 194 
Width: 86 
Height: 82 
LockLeft: (Wf 
LockTop: 
LockRight: [4 
LockBottom: [Wf 


Caption: Speicherr 
Default: 
Cancel: (} 
Enabled: (4 
Visible: WM 
HelpTag e 
BalloonHelp e 
DisabledBalloonH.. e 
AutoDeactivate (4 


TextFont: System (2) 
TextSize: 12 
Bold: [) 
Italic: 


OO 


Underline 


Numerische Eigenschaften (wie z.B. Left, Top, Width und Height) k6nnen als Zahlen oder als Formel eingegeben wer- 
den, deren Ergebnis eine Zahl ist. Fir Formeln stehen Ihnen folgende Operatoren zur Auswahl: +, -, *, /, \ (Integer-Divi- 
sion), % (Modulo) und “(Potenz). Sie k6nnen auch Klammern verwenden, um festzulegen, in welcher Reihenfolge 
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Unterfunktionen ausgeftihrt werden sollen. Sie konnen auch tiber Namen auf Eigenschaften referenzieren, was Ihnen 
erlaubt, Funktionen wie Top*2 oder Width+Left zu schreiben. Wenn eine Formel ungiiltig ist, wird der aktuelle Wert 
der Eigenschaft eingesetzt. Dies erlaubt es Ihnen (z. B.) den Ausdruck *2 als praktische Abktirzung ftir eine Verdoppe- 
lung des aktuellen Wertes einzugeben, wenn Sie gleichzeitig mehrere Objekte ausgewahlt haben. Mit + +Wert kénnen 
Sie zum aktuellen Eigenschaftswert einen Wert hinzuaddieren. Um beispielsweise 10 zu addieren, verwenden Sie + +10. 


Texteigenschaften 


Der Text eines EditField oder die Beschriftung eines PushButtons kénnen einfach durch Eingabe im Textbereich gesetzt 
werden.Wenn der Text, den Sie benotigen, zu lang ist, konnen Sie auf das Text-Icon klicken, um ein modales Fenster auf- 
zurufen, in das Sie langere Texte eingeben konnen. Ein typisches Eigenschaftenfenster sehen Sie in folgender Abbildung. 


Abb. 58: Text fiir die Ballon-Hilfe in einem separaten Fenster eingeben 


is] Eigenschaften 


Name: PushButton1 
Index: 
Super: PushButton v 


ControlOrder: 0 Klicken Sie auf diesen Knopf, um einen oK ) 

Left: 132 Datensatz in der REAL-Datenbank 
Top: 134 abzuspeichern. @ (Abbruch > 
Klicken Sie hier, um wee 
Height: 20 
langeren Text = 

3 LockLeft: 

einzugeben. ss 
LockRight: [ 
LockBottom: [ 


Wert bearbeiten 


Caption: Speichern © 
Default: (} 
Cancel: [} 


Enabled: 
wv 


Visible 


Helptag Le) 

BalloonHelp e 

DisabledBalloonH... e 
AutoDeactivate (4 


TextFont: System e 
TextSize: 12 
Bold: [| 
Italic: 


OO 


Underline 


Konstanten 


Sie kénnen im Eigenschaftenfenster als Wert fiir eine Eigenschaft auch eine Konstante verwenden. Damit konnen Sie 
z.B. sicher stellen, dass in Ihrer Applikation alle Kndpfe eines bestimmten Typs identisch beschriftet sind. Falls Sie spater 
diese Beschriftung andern wollen, miissen Sie nicht jeden einzelnen Knopf dndern, sondern es reicht aus, die Konstante 
zu modifizieren. 


Konstanten eignen sich auch zum Erzeugen mehrsprachiger Applikationen, da REALbasic einer Konstanten abhiangig 
von der Sprache automatisch verschiedene Werte zuweisen kann. 
Um eine Konstante zu verwenden, tragen Sie in das Eingabefeld der entsprechenden Eigenschaft ein Nummernzeichen 
»#", direkt gefolgt vom Namen der Konstanten ein. 


Im folgenden Beispiel sehen Sie die Eigenschaften eines PushButtons, ftir dessen Caption-Eigenschaft die Konstante 
,sichern“ eingesetzt wurde. 
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Abb. 59: Festlegen der Caption-Eigenschaft eines PushButtons uber eine Konstante 


Aussehen 
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Caption #Sichem | 
Default 

Cancel 

Enabled wv 

Visible Vv] 

HelpTag 

BalloonHelp 

DisabledBalloon.... 
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Wenn Sie die Applikation erzeugen, setzt der Compiler als Namen fiir den Knopf den Wert der Konstanten ,,Sichern“ ein, 
den Sie fiir die gewahlte Zielplattform und -Sprache vorgegeben haben. Zielplattform und -Sprache werden in den Com- 
piler-Einstellungen festgelegt. Mehr dazu erfahren Sie im Abschnitt ,,Lokalisieren mit Konstanten“ auf Seite 234. 


Auswahllisten 


Einige Steuerelemente gestatten die Auswahl eines festen Wertes tiber ein Popup-Menii. Wahlen Sie einfach den 
gewiinschten Wert aus dem Popup-Menii aus. In folgender Abbildung wird der CaptionPlacement-Eigenschaft eines 
BevelButton-Steuerelements der Wert Rechts der Grafik zugewiesen. 


Abb. 60: Einen Wert fiir eine Eigenschaft aus einem Popup auswahlen 


is] Eigenschaften 


Name: BevelButton1 


BevelButton 


ControlOrder: 
Left: 157 

Top: 57 
Width: 60 
Height: 22 
LockLeft: 
LockTop: 
LockRight: 
LockBottom 


Visible: 
HelpTag e 
BalloonHelp: © 
DisabledBalloonH... 12) 
AutoDeactivate (Wf 
Enabled: (4 
Caption: Namenlos =) 
CaptionAlign: Systemausrichtung ¥; 
CaptionPlacement Normal =] 
CaptionDelta 
+m Links der Grafik ¥ 
\conAlign: Unter der Grafik a4 


'conDX: Uber der Grafik 
IconDY: 


Bevel: 0 - Kleiner Bevel 


44 


HasMenu: 0~- Kein Mend 


Farbeigenschaften 


Farbeigenschaften zeigen die Farbe an. Diese kann gedndert werden, indem man das Farbfeld anklickt und in der Farb- 
auswahl eine andere Farbe wahlt oder eine Farbe aus dem Farbfenster zieht und auf das Farbfeld fallen lasst. So besitzen 
die Steuerelemente Rechteck und abgerundetes Rechteck Eigenschaften, die den Rand und die Fiillfarbe kontrollieren. 
Sie kénnen diese Farben einstellen, indem Sie im Eigenschaftenfenster auf die entsprechende Farbe klicken und eine 
andere zuweisen. 
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Abb. 61: Farbe im Eigenschaftenfenster auswahlen 


is) Eigenschaften 


Name: RoundRectanglel 
Index: 
Super: RoundRectangle w 
Position 
ControlOrder: 3 
Left: 48 
Top: 249 
Width: 80 
Height: 22 
LockLeft: 
LockTop: 
LockRight: 
LockBottom: 


Visible: 
HelpTag: 
BalloonHelp 
DisabledBalloonH... 
AutoDeactivate 
Enabled: 


1 


BorderWidth: 


OvalWidth: 16 
OvalHeight: 16 


lee) 


Steuerelemente léschen 


Sie kénnen ein Steuerelement entweder tiber das Kontextmenti des jeweiligen Steuerelements oder iiber einen Menii- 
befehl aus einem Fenster entfernen. 


1. Holen Sie das Fenster, auf dem das Steuerelement platziert werden soll, nach oben. Ist es nicht gedffnet, so 6ffnen 
Sie es mit einem Doppelklick auf seinen Namen im Projektfenster. 

2. Klicken Sie auf das zu loschende Steuerelement, um es zu selektieren. 

3. Loschen Sie das Steuerelement mit Bearbeiten/Ausschneiden, Bearbeiten/Léschen oder Backspace. Oder fiihren 
Sie einen ctrl-Klick (Windows: Rechtsklick) auf dem Steuerelement aus und wahlen Léschen aus den Kontextmenii. 
Falls Sie eine Kopie des geloschten Steuerelements in der Zwischenablage ablegen méchten, wahlen Sie 
Ausschneiden anstelle von Léschen. 


Die Ebenen 


Jedes Steuerelement liegt in einer Ebene (Layer), die man sich wie eine Folie aus durchsichtigem Plastik vorstellen kann, 
auf der das Steuerelement liegt. Diese ,,Folien“ liegen alle iibereinander und die Reihenfolge bestimmt, welches Element 
iiber einem anderen liegt. Das Format-Menti enthalt Kommandos, mit denen Elemente innerhalb dieser Ebenen nach 
oben und nach unten bewegt werden kénnen, so dass sich die Zeichenreihenfolge verandert. Diese Reihenfolge spielt 
nur dann eine Rolle, wenn sich Steuerelemente tiberdecken. 


Abb. 62: Das Format-Menii 


A Schrift > 
@ Gréke > 
Astil > 


© Zeige Steuerelemente-Reihenfolge 
© Reihenfolge... 


GEN e beweger 

Gg Ar 1 x= 
Nach hinten bewegen 3 - 
Ans Ende setzen %- 


“@ Objekte ausrichten > 
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Wenn Sie Steuerelemente auf eine GroupBox oder ein TabPanel legen, muss die GroupBox oder das TabPanel unter den 
anderen Elementen liegen, da sonst die anderen Elemente nicht sichtbar sind. Die Ebenen bestimmen auch die Reihen- 
folge, in der die Steuerelemente beim Betitigen der Tabulatortaste ausgewahlt werden. Allerdings miissen Sie die Ebe- 
nen nicht verdndern, um die Reihenfolge, in der sie angesprungen werden, zu bestimmen. Stattdessen k6nnen Sie den 
Mentipunkt Bearbeiten/Reihenfolge verwenden. 


Abb. 63: Der Reihenfolge-Dialog 


Reihenfolge 
PushButton2 (a) 
PushButton1 
ListBoxl f abbruch > 
€ Rauf ) 
f ay 


Der Fokus 


Der Fokus ist eine visuelle Markierung, die dem Anwender mitteilt, welches Steuerelement Tastatureingaben empfingt. 
Unter Mac OS kann der Fokus nur auf den Steuerelementen EditField, ComboBox, Canvas, PushButton und ListBox lie- 
gen. Unter Windows kann der Fokus zusatzlich auf Slider-, PopupMenu- und Checkbox-Steuerelementen liegen. Unter 
Linux kénnen EditField, ComboBox, CheckBox, PushButton, PopupMenu und Slider den Fokus bekommen. 


EditFields 


Wenn der Fokus auf einem EditField liegt erscheint ein blinkender Cursor, der Texteingaben entgegennimmt. Das Verhal- 
ten des EditFields bei gedriickter Tabulatortaste wird durch die AcceptTabs-Eigenschaft geregelt. Wenn diese Eigenschaft 
den Wert False hat, bewirkt das Driicken der Tabulatortaste, dass das nachste Steuerelement in der Reihenfolge den 
Fokus erhalt. Wenn die AcceptTabs-Eigenschaft den Wert True besitzt, akzeptiert das EditField das Tabulatorzeichen 
genau wie jeden Buchstaben als Texteingabe und behalt den Fokus. 


In der folgenden Abbildung liegt der Fokus auf dem EditField Vorname“. Anders als unter Mac OS X erhalt das EditField 
unter Windows und Linux keine Fokusmarkierung. Lediglich die blinkende Einftigemarke deutet auf den Fokus hin. 


Abb. 64: EditFields - einmal mit und einmal ohne Fokus 


£0 semenics BSED a Namentos 
Datei Bearbeiten 
Vorname | Vorname: 
Nachname: Nachname: —| Vomame: 


Se Nachname: 
sealable Sie Abbrechen Sichern 


ComboBoxen 


Wenn der Fokus auf einer ComboBox liegt, wird der ausgewahlte Eintrag hervorgehoben und ein blinkender Cursor 
angezeigt. Unter Mac OS wird zusatzlich rund um die ComboBox ein Rahmen gezeichnet. Eine ComboBox mit Fokus 
verhilt sich wie ein EditField mit Popup-Menii. Mit den Pfeiltasten k6nnen Sie einen Eintrag auswahlen und die Auswahl 
mit Enter bestatigen. Natiirlich konnen Sie den ausgewahlten Eintrag auch bearbeiten und ersetzen. 


Abb. 65: ComboBoxen 


am [i —— >| [a >| Fm Tonart 
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ListBoxen 


Wenn eine ListBox auf dem Mac den Fokus besitzt, zeichnet REALbasic einen Rahmen um die ListBox. Wenn unter Win- 
dows der Fokus auf einer ListBox liegt, zeichnet REALbasic entweder ein gestricheltes Rechteck um das zuvor selektierte 
Listenelement oder — falls kein Element selektiert war — um das erste Listenelement. Wenn das zuvor selektierte Objekt 
aus dem Sichtbereich gescrollt wurde, gibt es keine sichtbare Veranderung im Erscheinungsbild der ListBox. 


Abb. 66: ListBox mit Fokus 


Heidelberg 

Koln (| 
Munchen 
Hamburg 
Berlin 
Leipzig 


Frankfurt 


Windows, keine Selektion Windows, mit Selektion Macintosh 


Eine Listbox reagiert auf die Pfeiltasten T und W. Wenn Sie eine dieser Tasten driicken, dndert sich der ausgewahlte Ein- 
trag entsprechend. Die ListBox erhalt auch alle anderen Tastendriicke des Anwenders. Damit kénnen Sie eine automati- 
sche Positionierung in der Liste implementieren, die den zum gedriickten Buchstaben passenden Eintrag selektiert. Ein 
Beispiel ftir eine solche ,,type selection“ wird mit REALbasic mitgeliefert. 


Anmerkung: Wenn die ListBox das einzige Steuerelement des Fensters ist, das den Fokus erhalten kann, erhilt sie diesen 
beim Offnen des Fensters automatisch und behialt ihn bei. 


Canvas-Steuerelemente 


Das Canvas-Steuerelement kann den Fokus erhalten. Deshalb bietet es sich an, eigene Steuerelemente, die ebenfalls den 
Fokus erhalten konnen sollen, auf Basis des Canvas-Steuerelements zu realisieren. So konnen Sie zum Beispiel das Can- 
vas-Steuerelement dazu verwenden, andere Steuerelemente zu simulieren, die auf dem Macintosh keinen Fokus erhal- 
ten kénnen, wie beispielweise Buttons und Popup-Meniis. Im Gegensatz zu den anderen Steuerelementen, die den 
Fokus erhalten kénnen, ist die AcceptFocus-Eigenschaft des Canvas-Steuerelements standardma(sig auf FALSE gesetzt. 
Damit es also den Fokus erhalten kann, muss die AcceptFocus-Eigenschaft auf TRUE gesetzt werden. Dies kann man mit- 
tels Code oder iiber das Eigenschaftenfenster erreichen. Das Canvas-Steuerelement besitzt auferdem eine Accept- 
Tabs-Eigenschaft, die festlegt, ob das Driicken der Tabulatortaste den Sprung zum nachsten Steuerelement im Fenster 
bewirkt oder das Tabulatorzeichen zur weiteren Verarbeitung an das Canvas-Steuerelement tibergeben wird. Wenn die 
AcceptTabs-Eigenschaft FALSE ist, bewirkt das Driicken der Tabulatortaste, dass das Canvas Steuerelement den Fokus 
verliert und an das nachste Steuerelement weiter gibt. 


Abb. 67: Fokus-relevante Eigenschaften eines Canvas Steuerelements 


lAussehenss—‘—s—sSCS 
Visible: 
HelpTag: (eS) 
BalloonHelp © | 
DisabledBalloonH... ra) 


AutoDeactivate cA 
Backdrop: Keins 


Enabled: Mw 


UseFocusRing: Mw 


AcceptFocus: Mw 
AcceptTabs: [| 


4 


Falls die AcceptFocus- und UseFocusRing-Eigenschaften TRUE sind, zeigt das Canvas-Steuerelement auf dem Macintosh 
den Fokus als Rahmen um das Steuerelement an. Unter Mac OS Classic entspricht die Farbe den Einstellungen im Kon- 
trollfeld ,,Erscheinungsbild“, unter Mac OS X den Benutzereinstellungen unter ,,Allgemeine Einstellungen“. 
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Abb. 68: Canvas-Steuerelemente mit und ohne Fokus 


[2] @ 


Mac OS 9 Mac OS X 


Unter Windows hat UseFocusRing leider keinerlei Auswirkung. Es gibt keine automatische visuelle Rtickmeldung fiir den 
Fokus. Jedoch ist es mittels Programmierung kein grofses Problem, den Fokus sichtbar zu machen. In der Sprachreferenz 
zum Canvas-Steuerelement wird gezeigt, was daftir zu tun ist. 


PopupMenu 


Wenn ein PopupMenu unter Windows den Fokus bekommt, wird das derzeit selektierte Objekt hervorgehoben. Es rea- 
giert wie die ListBox auf die Pfeiltasten und besitzt die gleiche Autolocator-Funktion. Folgende Abbildung zeigt ein 
Popup mit der gleichen Liste wie bei der Listbox im Beispiel zuvor, einmal mit und einmal ohne Fokus. Wenn der Anwen- 
der den Buchstaben ,,L" tippt, wird der Eintrag Leipzig“ ausgewahlt; ,,F“ wahlt Frankfurt aus usw. 


Abb. 69: PopupMenu ohne und mit Fokus 


[Heidelbera a [Leonard y| Heidelberg [Leonard >| 


Ohne Fokus Mit Fokus 


CheckBox 


Wenn eine CheckBox den Fokus bekommt, erscheint ein gestricheltes Rechteck um die Beschriftung der CheckBox. 
Wenn Sie die Leertaste driicken, wahrend der Fokus auf der CheckBox liegt, schaltet dies den Status der CheckBox zwi- 
schen angewahlt und nicht angewahlt hin und her. 


Abb. 70: CheckBox ohne und mit Fokus 


T Mitglied [ Druckvorschau 


Ohne Fokus Mit Fokus 


PushButton 


Wenn ein PushButton den Fokus erhalt, wird ein gestricheltes Rechteck um die Beschriftung des Knopfes gezeichnet. 
Wenn Sie die Leertaste driicken, wahrend der PushButton den Fokus besitzt, wird der Knopf gedriickt, das bedeutet, 
sein Action-Event-Handler wird ausgeftihrt. 


Abb. 71: PushButton ohne und mit Fokus 


Speichem | Ok | © Speichem | 


Ohne Fokus Mit Fokus 


Slider 


Wenn der Focus auf einem Slider liegt, wird ein gestricheltes Rechteck um das Steuerelement gezeichnet. Das Driicken 
von Pfeiltaste T oder <- erniedrigt den Wert des Sliders und das Driicken von Pfeiltaste L oder > erhdht den Wert des 
Sliders. Der Betrag, um den sich der Wert bei jedem Tastendruck andert, wird durch die LineStep-Eigenschaft des Sliders 
festgelegt. Normalerweise hat der Slider einen Wertebereich von 0 bis 100 und LineStep ist 1. Der Anwender kann auch 
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irgendwo in den Slider klicken, um den Wert direkt zu setzen. Der Betrag, um den sich der Slider bei jedem Klick 
bewegt, wird tiber die PageStep-Eigenschaft festgelegt. Die Voreinstellung fiir PageStep ist 20. 


Abb. 72: Slider ohne und mit Fokus 


———— 


Ohne Fokus Mit Fokus 


ScrollBar 


Wenn ein ScrollBar den Fokus bekommt, beginnt der Schieberegler zu pulsieren. Dies zeigt folgende Abbildung: 
Abb. 73: ScrollBar ohne und mit Fokus 


a Te a 


Ohne Fokus Mit Fokus 


Tastatursteuerung 


Unter Mac OS X kénnen Sie in der ,Tastatur & Maus“-Systemeinstellung die Navigation tiber Tastatur“ aktivieren. Diese 
erméglicht dem Anwender, Programme nur mit der Tastatur zu bedienen, die normalerweise mit Tastatur und Maus 
bedient werden. Zum Beispiel arbeiten das Menti und das Dock standardmafig mit Mausbewegungen. Mit aktivierter 
Tastatursteuerung k6nnen Sie mit den Pfeiltasten durch Mentis navigieren und den gewiinschten Eintrag mit der Leer- 
taste auswahlen. 


@8e0 Tastatur & Maus j=) 


Alle einblenden Monitore Ton Netzwerk Startvolume 


Tastatur Trackpad _|_ Maus |=Tastatur-Kurzbefehle } 


Doppelklicken Sie zum Andern eines Kurzbefehls in den Kurzbefehl und 
driicken Sie die neue Tastenkombination. 


| Ein Beschreibung ‘Kurzbefehl 

4 YWNavigation Uber Tastatur 

w Tastatursteuerung ein- oder ausschalten “FL 

a Meni auswahlen “F2 

ca) Dock auswahlen Ske: 

ica] Aktives Fenster oder Fenster dahinter auswahlen aF4 

a Symbolleiste auswahlen AES 

ca) Paletten-Fenster auswahlen “F6 

ica) Fenster drehen B< 

a Steuerelemente in Fenstern abwechselnd auswahlen OFT a 
@ yDock ’ 


__) Tastatursteuerung einschalten 
Aktivieren Sie alle Bereiche der Tastatur, damit Sie Tabulator-, Pfeil- und andere 
Tasten zum Auswahlen von Tasten, Listen und anderen Bildschirmelementen @ 
verwenden konnen. 


Mit aktivierter Tastatursteuerung konnen Sie auch Steuerelemente tiber die Tastatur steuern, die normalerweise keinen 
Fokus bekommen. So k6nnen Sie mit Hilfe der Tastatursteuerung den Wert eines RadioButtons setzen, ohne die Maus 
zu verwenden. Das Steuerelement, das gerade Tastatureingaben entgegen nimmt, ist von einer Aura umgeben. Mit der 
Tabulatortaste konnen Sie zum nichsten Steuerelement wechseln. 


Beachten Sie, dass dies eine systemweite Einstellung ist, die vom Benutzer aktiviert werden muss. Sie k6nnen sich nicht 
darauf verlassen, dass diese Einstellung aktiviert ist und konnen diese auch nicht fiir den Benutzer aktivieren. 
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Steuerelemente duplizieren 
Ein Steuerelement ldsst sich duplizieren, indem man es auswahlt und entweder Bearbeiten/Duplizieren aufruft, es mit 
gedriickter alt-Taste verschiebt oder $8-D (Windows: Strg-D) driickt. 


Eventuell dem Steuerelement zugeordneter Programmcode wird dabei nicht dupliziert. 


Die Objekthierarchie 


Da Steuerelemente Objekte sind und REALbasic eine objektorientierte Programmiersprache ist, leiten sich alle Steuer- 
elemente von anderen Klassen ab. Unter anderem bedeutet dies, dass jedes Steuerelement Eigenschaften von der Klasse 
erbt, von der es abstammt. Die meisten Steuerelemente sind Unterklassen der RectControl-Klasse. Das heifst, dass jedes 
dieser Steuerelemente automatisch Eigenschaften der RectControl-Klasse erbt. 


In der Sprachreferenz ist die Elternklasse eines Steuerelementes als tibergeordnete Klasse aufgelistet und kann mittels 
Mausklick direkt aufgerufen werden. Um alle Eigenschaften und Methoden eines Steuerelements einzusehen, miissen 
Sie sich sowohl die Eigenschaften und Methoden der tibergeordneten Klasse als auch die des Steuerelements ansehen. 
Wenn die Super-Klasse eines Steuerelements wiederum eine Super-Klasse hat, miissen Sie in der Hierarchie weiter nach 
oben gehen. 


Die RectControl-Klasse hat die Eigenschaften Width, Height, Top und Left. Sie bestimmen Position und Grdfe. Da alle 
Steuerelemente, die sich von der RectControl-Klasse ableiten, diese Eigenschaften tibernehmen, werden diese in der 
Sprachreferenz nicht fiir jeden RectControl-Typ nochmals aufgelistet. 


Die Klassenhierarchie wird im Kapitel ,,Die Klassenhierarchie* der Sprachreferenz abgebildet. 


Sie wird auch sichtbar, wenn sie im Kontextmenii des Fenstereditors den Mentipunkt Hinzuftigen/Beliebig aufrufen. 


Auslésen von Aktionen mit Kndpfen 

Es gibt vier Arten von Knopfen, die eine Aktion auslésen: CheckBox, PushButton, BevelButton und RadioButton. Sie lei- 
ten sich von der RectControl-Klasse ab. 

PushButton 


Wird ein PushButton angeklickt, dann wird er eingedriickt gezeichnet, so dass der Benutzer sofort sieht, dass er jetzt 
eine Aktion auslést. Daher werden PushButtons dazu verwendet, eine Aktion einzuleiten, die direkt danach auf dem 
Bildschirm sichtbar wird, also beispielsweise das SchliefSen eines Fensters oder Drucken eines Dokuments. Unter Win- 
dows kann der PushButton den Fokus erhalten. 


Abb. 74: Ein PushButton in gedriicktem und ungedriicktem Zustand: 


amo ews oe 


Mac OS Classic Mac OS X Windows 


BevelButton 


Das BevelButton-Steuerelement besitzt ahnliche Merkmale wie ein PushButton und einige leistungsfahige Zusatzfunkti- 
onen. Sie konnen eine PICT-Grafik auf dem BevelButton platzieren, die Ausrichtung und Position des Textes bzw. der 
Grafik beeinflussen, ein Popup-Menii hinzufiigen und festlegen, welche Riickmeldung der Anwender beim Anklicken 
des Knopfes erhalten soll. 


Abb. 75: Verschiedene BevelButtons: Als Icon, Text und ,,Combo” 


@| ox] sount @ 
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Abb. 76: Bevel-GréBen 


Classic Mac OS Mac OS X (GrdBe Windows 
hat keinen Effekt) 
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Nur unter Windows XP unterstiitzt die Option ,,Kein Bevel“ einen Mouse-Over-Effekt. Dabei wird nur die Beschriftung 
des Buttons dargestellt. Erst wenn der Mauszeiger in den Bereich des Buttons bewegt wird, wird der Button selbst darge- 
stellt. Unter allen anderen Betriebssystemen entspricht die Option ,.Kein Bevel der Option ,,Kleiner Bevel". 


Unter Mac OS X werden vier zusatzliche Bevel-Typen unterstiitzt. Dies sind: abgerundet, rund, gro& & rund und Auf- 
klappdreieck. Das Aufklappdreieck wechselt beim Klicken zwischen zwei Zustanden: Spitze nach oben oder Spitze nach 
unten. Die anderen Bevel-Typen werden beim Klicken hervorgehoben. Unter allen anderen Betriebssystemen werden 
diese Bevel-Typen als ,,Kleiner Bevel dargestellt. 


CheckBox 


Eine CheckBox ist ein Steuerelement mit einer Zustandsvariablen, die die Werte TRUE (Hakchen wird dargestellt) und 
FALSE (kein Hakchen) besitzt. Sie wird zum Aktivieren oder Deaktivieren von Optionen — meist Voreinstellungen — ver- 
wendet. Das Anklicken einer CheckBox sollte nicht zu einer sofortigen Reaktion des Programms fiihren, mit Ausnahme 
des Aktivierens oder Deaktivierens anderer Steuerelemente. 


Abb. 77: Eine CheckBox in den Zustanden ,,checked” und ,,unchecked” 


M Druckvorschau M Druckvorschau M Druckvorschau 
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Wenn Sie geniigend Platz in einer Dialogbox haben, dann sollten Sie iiberlegen, ob es nicht besser ist, die beiden mégli- 
chen Optionen, die die CheckBox anbietet, tiber ein Paar RadioButtons zu realisieren (siehe unten), da besonders ftir 
ungetibte Anwender dadurch oft klarer wird, was hier ausgewahlt werden kann. 


RadioButton 


RadioButtons funktionieren wie die Stationswahltasten an einem alten Radio. Driickt man einen, wird er aktiviert und 
ein anderer daftir ausgeschaltet. Daher verwendet man RadioButtons, um dem Benutzer die Auswahl zwischen mehre- 
ren Optionen zu geben, die sich gegenseitig ausschliefSen. Die Kndpfe, die zusammengehGren, sollten in einer Gruppe 
dargestellt werden. 


Abb. 78: Eine Gruppe von RadioButtons, bei der ein Knopf gedriickt ist 


© Drama © Drama ™ Drama 
@ Komidie ® Komédie @ ‘Komodie 
O Sci-Fi O Sci-Fi C SciFi 


Sollen in einem Fenster mehrere Gruppen von RadioButtons eingesetzt werden, miissen Sie diese jeweils in einem 
GroupBox-Steuerelement platzieren, damit die einzelnen Gruppen unabhiangig voneinander reagieren (siehe ,,Group- 
Box“ auf Seite 122). 
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Steuerelemente zur Eingabe und zum Anzeigen von Text 


REALbasic stellt verschiedene Steuerelemente zum Anzeigen von Text zur Verfiigung. Vom Typ und den Eigenschaften 
des gewahlten Steuerelements ist es abhdngig, ob der Text auch selektierbar ist oder bearbeitet werden kann. 


Diese Steuerelemente leiten sich von der RectControl-Klasse ab. 


StaticText 


In StaticText-Objekten kann Text angezeigt werden, den der Benutzer weder selektieren noch andern kann. Daher wer- 
den sie meist zum Beschriften von anderen Objekten verwendet. Da der Text der Beschriftung mittels Programmiercode 
verandert werden kann (iiber die Text-Eigenschaft des Objekts), kann man auch dynamischen Text erzeugen, der aller- 
dings nur ausgelesen werden kann (read only). So kénnen zum Beispiel schreibgeschiitzte Felder einer REAL- 
basic-Datenbank auf einfache Art und Weise mit Hilfe von statischem Text erstellt werden. Sie konnen dies miihelos 
erreichen, indem Sie ein Staticfext- zusammen mit einem DataControl-Steuerelement verwenden. Das DataCont- 
rol-Steuerelement erlaubt es Ihnen, ein Datenbankfeld mit dem StaticText-Objekt zu verkniipfen und in diesem den 
aktuellen Feldinhalt anzuzeigen, wahrend der Anwender durch die Datensatze blattert. 


Abb. 79: Ein StaticText-Objekt zur Beschriftung eines Popup-Meniis: 


-———eFilm: | Titanic = Mac Classic 
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EditField 


EditFields zeigen Text an, der vom Benutzer gedndert werden kann. EditFields konnen ein- und mehrzeilig sein. Ein 
mehrzeiliges EditField kann horizontale und vertikale Scrollbalken anzeigen und Text in verschiedenen Schriftarten, -sti- 
len und -gro%en enthalten. Auch Absatze k6nnen — mit der StyledText-Klasse — separat linksbiindig, zentriert oder 
rechtsbiindig ausgerichtet werden. Weitere Informationen zur StyledText-Klasse finden Sie in der Sprachreferenz. 

Ein einzeiliges EditField kann auch als Passwort-Feld konfiguriert werden — es zeigt dann fiir jeden eingegebenen Buch- 
staben einen schwarzen Kreis. Sie k6nnen auch Eingabemasken definieren, um die Eingabe Zeichen fiir Zeichen zu fil- 
tern. Zum Beispiel konnen Sie fiir ein Telefonnummern-Feld definieren, dass dieses nur Ziffern akzeptiert. AufSerdem 
k6nnen Sie die Anzahl der erlaubten Zeichen festlegen. 


Abb. 80: EditFields in einer Datenbankmaske 
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Benutzerinteraktion tiber Steuerelemente 117 


Abb. 81: Ein EditField mit Text in verschiedenen Schriften 
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ComboBox 


Die ComboBox ist eine Kombination aus einen einzeiligen EditField und einem PopupMenu. Der Benutzer kann Text 
eingeben, aus einer Liste von Eintragen wahlen oder einen Eintrag bearbeiten. Ein ComboBox-Steuerelement kann nicht 
als Passwortfeld verwendet werden. Auch das Definieren eines Eingabefilters ist nicht moglich. 


Steuerelemente zum Anzeigen und Eingaben von numerischen Werten 


REALbasic verfiigt tiber Steuerelemente, die dem Benutzer erlauben, einen Wert aus einem bestimmten Wertebereich 
auszuwahlen. Manchmal steuern diese Steuerelemente die Anzeige eines anderen Objekts. Beispielsweise verandert ein 
ScrollBar-Steuerelement die Anzeige in einem EditField- oder Canvas-Objekt. 


Scrollbar 


Es gibt horizontale und vertikale Scrollbars. Beide Ausrichtungen finden sich in der Steuerelementepalette. Sie knnen 
ein horizontales Scrollbar-Steuerelement in die andere Orientierung drehen, indem Sie seine Grd&e so verandern, dass 
die vertikale Ausdehnung gr6fer wird als die horizontale. Scrollbar-Steuerelemente sollten immer 16 Pixel breit sein. 


Abb. 82: Horizontale und vertikale Scrollbar-Steuerelemente 
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Slider 


Mit Erscheinen von Mac OS 8 wurde die Macintosh-Benutzerschnittstelle um Slider erweitert. Slider funktionieren wie 
Scrollbar-Steuerelemente, diese werden jedoch gewohnlich mit Textinhalten oder anderen Fensterinhalten in Verbin- 
dung gebracht und weniger mit numerischen Werten. Mit einem Slider steht nun eine intuitive Moglichkeit zum Vergr6- 
Sern oder Verkleinern eines numerischen Wertes zur Verfiigung. 

Wie bei einem Scrollbar-Steuerelement kann man durch entsprechende Grofsenanderung einen horizontalen oder verti- 
kalen Slider erzeugen. Ein Slider erhalt automatisch die korrekten Proportionen, egal wie grof Sie das Slider-Objekt 
anlegen. 


Abb. 83: Horizontale und vertikale Slider 


ee 


Slider k6nnen unter Linux und Windows den Fokus erhalten. Auf diesen Plattformen werden Events ausgelést, wenn ein 
Slider den Fokus erhiilt oder verliert. 
Progressbar 


Progressbars zeigen den Fortschritt einer bestimmten Aktion oder eine Kapazitat (wie die Speicher- oder Festplattenbe- 
legung) an. Anders als Scrollbars oder Slider dienen Progressbars nur zur Anzeige eines Wertes, nicht zur Eingabe. Sie 
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sind nur horizontal darstellbar. Ist vorher nicht genau zu bestimmen, wie lange ein Prozess dauern wird, macht man von 
einem geringelten Streifen Gebrauch (im Englischen ,,Barber Pole“ genannt, in Anlehnung an die sich drehenden gerin- 
gelten Rohren, die an den Ladenschildern von Friseurgeschaften mitunter angebracht sind, um die Aufmerksamkeit von 
Passanten auf das Schild zu lenken). 


Unter Windows wird ein Prozess, dessen Dauer man nicht voraussagen kann, in Form eines einfachen Blockes darge- 
stellt, der sich vor und zurtick bewest. 


Abb. 84: Zeitlich bestimmte bzw. unbestimmte ProgressBars 


 ———— = 
SS See ——— | 


Steuerelemente fiir eine Auswahlliste 


RadioButtons und Checkboxes k6nnen dem Benutzer eine beschrankte Auswahl an Méglichkeiten prasentieren. Manchmal 
ist die Verwendung von Checkboxes bzw. RadioButtons nicht méglich. Dies ist vor allem dann der Fall, wenn. .. 

e ... essehr viele Wahlméglichkeiten gibt. 

e ... sich die Wahlméglichkeiten je nach Situation standig andern k6nnen. 

e ... mehr als eine Spalte angezeigt werden muss. 


Liegt keiner dieser Falle vor, sollten Sie méglichst mit RadioButtons oder Checkboxes arbeiten. Sie sind vor allem ftir 
ungetibte Benutzer erheblich einfacher zu handhaben, da alle Wahlméglichkeiten zu sehen sind. 


Kontextments 


Kontextmentis zeigen eine Liste von Wahlméglichkeiten in einem Menii an, wenn der Benutzer bei gedriickter ctrl-Taste 
(Windows: rechte Maustaste) auf ein Steuerelement klickt, das ein MouseDown-Event empfangen kann. Ein Contextual- 
Menu-Objekt kann dazu verwendet werden, um ein Kontextmenii ftir einige der sichtbaren Steuerelemente anzuzeigen. 


Friihling Friihling 
Sommer Sommer 


Abb. 85: Ein Kontextmenii 


Herbst " 


Winter 


ListBox 


In ListBoxen kann eine scrollbare Liste von Werten angezeigt werden. Der Benutzer kann mit der Maus oder den Pfeiltas- 
ten einen Wert ausw4hlen. ListBoxen kénnen mehrere Spalten enthalten, hierarchisch angelegt sein und gestatten auch 
die Auswahl von mehreren Eintragen gleichzeitig. 

Die Steuerelementepalette hat separate Icons fiir ein- und mehrspaltige ListBoxes. Sie konnen die Anzahl der Spalten 
einer ListBox jedoch einfach durch Setzen der Eigenschaft ColumnCount im Eigenschaftenfenster dndern. Sie konnen 
beide Icons verwenden, um eine ListBox in einem Fenster einzuftigen, und nachtraglich die Anzahl der Spalten dndern. 
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Abb. 86: Beispiele von ListBoxen 


Schmitt 020-1212 Thomas Schmitt 020-1212 
Miller 021-1313 Fred Miller 021-1313 
Maier 022-1435 Maria Maier 022-1435 
Schneider 033-5467 Karen Schneider 033-5467 


«p> 


Einzelne Spalte und mehrere Spalten 


Vorname 


(Rober Schmitt 020-1212 


[Robert Schmitt 020-1212 ; 

OFrank = Miiller 021-1313 = Hes ee tos tase 
Maria Maier 022-1435 — apeteaiad 7 
[Manfred Schneider 033-5467 a |) Manfred Schneider 033-5467 


Mehrere Spalten mit Kopfzeilen und Checkboxen 


vv Michigan y Michigan 
Grand Blanc Grand Blanc 
Bad Axe Bad Axe 
Flint Flint 
Benton Harbor Benton Harbor 
Detroit 
> Ohio 
y Minnesota 
St. Paul 
Frostbite Falls Frostbite Falls 


Hierarchische Listbox 
Zellen, Reihen und Spalten kénnen mit einer Schattierung unterlegt werden. In Abbildung 87 beispielsweise sind die 
aufeinanderfolgenden Reihen verschiedenfarbig unterlegt. Auch die ausgewahlte Reihe kann charakteristisch eingefarbt 
werden. 


Abb. 87: Ein Beispiel fiir eine angepasste Schattierung 


Sie konnen ebenfalls Anpassungen ftir die Begrenzungen von Zeilen und Spalten vornehmen. Abbildung 88 zeigt die vier 
verschiedenen horizontalen und vertikalen Begrenzungstypen, die Sie mittels einer Programmroutine zeichnen k6nnen. 
Die Grundeinstellung ist ,None“. 


Abb. 88: Die vier Stile der ListBox-Begrenzungen 


_Name ‘Telefon —_— E-Mail 
8337772 oliver@web.de 

222333 |peter@msn.org 

1234567 Frido@lin.net 


___Name__|_ Telefon E-Mail 
Oliver 337772. oliver@web.de _ Oliver 
Peter 


Fridolin 


David@toll.com 
Diinn gepunktet Diinn durchgehend 
Name Telefon E-Mail Name | Telefon | E-Mail 
Oliver 8337772 _lloliver@web.de 
222333 . Peter [222333 |[peter@msn.org 
1234567 Fridolin 1234567 Frido@lin.net 
984432 i k David 984432 David@toll.com 
Dick durchgehend Doppelt diinn durchgehend 


Sie ko6nnen diese Begrenzungstypen auch auf ausgew4dhlte Zellen oder ausgewahlte Begrenzungslinien anwenden. In 
Abbildung 89 ist eine Zelle mit dem Begrenzungstyp ,,Thick Solid“ hervorgehoben, wohingegen der tibrige Teil der List- 
Box den Begrenzungstyp ,Thin Dotted“ verwendet. 
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Abb. 89: Eine angepasste Begrenzung um eine ausgewahlte ListBox- Zelle 


Name |__ Telefon 
_Oliver 337772 


1234567 
4432 


Wenn Sie einer ListBox einen Header mit Spaltentiberschrift hinzuftigen, kann der Benutzer die Informationen der List- 
Box sortieren, indem er eine Spaltentiberschrift anklickt. Sie konnen die Sortierung der Reihen der ListBox auch mittels 
einer Programmroutine vornehmen. Die Sortierrichtung wird tiber einen kleinen Pfeil im Kopf-Bereich angezeigt. 


Abb. 90: Eine nach der Spalte Name sortierte ListBox 


(Name “| Alter Stadt 


Die Standardsortiermethode arbeitet alphabetisch und liefert daher keine giiltigen Ergebnisse ftir Zahlen und Datum- 
seintrage. Diese Datentypen sortieren Sie mit Hilfe des CompareRows-Event der ListBox. Im folgenden Beispiel wird 
Programmiercode eingesetzt, der die Werte benachbarter Reihen in der ,,Alter“-Spalte vergleicht, um die gewtinschte 
Sortierreihenfolge zu erhalten. 


Abb. 91: Standardsortierung und angepasste Sortierung einer Zahlenspalte 


Name Alter Stadt | Name [euAltere@| Stadt 


Standard-Sortierung Angepasste Sortierung 


Fiir mehrspaltige Listboxen k6nnen Sie festlegen, ob dem Benutzer erlaubt sein soll, die Spaltenbreite durch Verschie- 
ben der Trennlinien, zu variieren. Sie kGnnen dies Spalte fiir Spalte festlegen, oder aber fiir die gesamte ListBox. Wenn 
der Benutzer die Spaltenbreite verindern darf, kGnnen Sie auch die Minimal- und Maximalgr68e der Spalten festlegen. 
Wenn die Verinderbarkeit der Spaltenbreite aktiviert ist, verwandelt sich der Mauszeiger beim Uberfahren der Spalten- 
grenzen in ein Symbol zum Andern der Spaltenbreite. Im folgenden Beispiel wird die Gréf’e der Namensspalte veriin- 
dert, um der Spalte mit den E-Mail-Adressen mehr Platz einzuraumen. 


Abb. 92: Anderung der Breite der Spalte Name 


Name 4 Telefon | E-Mail 
Herbert 020-1234 herbert@freenet.de 
Julius 021-6677 julius@hotmail.com 
Peter 099-4347 peter@web.de 
Frank 077-5566 frank@gmx.de 


Susanne 010-9090 susi@epost.de 


Sie konnen dem Benutzer sowohl fiir einspaltige als auch ftir mehrspaltige ListBoxen erlauben, Zeilen zu draggen, um 
sie neu anzuordnen. Beim Draggen wird das Ziel dieser Aktion mittels einer durchgingigen Linie zwischen den Zeilen 
gekennzeichnet. In folgendem Beispiel wird die Zeile mit ,Herbert* zwischen ,,Julius“ und ,,Peter“ gedraget. 
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Abb. 93: Veranderung der Reihenfolge durch Draggen einer Zeile 


Name Telefon E-Mail 
Herbert 020-1234 herbert@freenet.de 
Julius 021-6677 julius@hotmail.com 
Peter 099-4347 hh peter@web.de 
Frank 077-5566 frank@gmx.de 
Susanne 010-9090 susi@epost.de 


Hierarchische ListBoxen unterstiitzen das Draggen von Zeilen nicht. 


PopupMenu 


PopupMenu-Objekte sind immer dann sehr praktisch, wenn Sie eine Spalte verschiedener Wahlméglichkeiten bendti- 
gen, aber nur sehr wenig Platz zur Verfiigung steht. Ein PopupMenu zeigt eine Auswahl von Eintrdgen an, aus denen der 
Benutzer wahlen kann. Der ausgewahlte Eintrag wird durch ein Hakchen hervorgehoben. 

Abb. 94: Ein PopupMenu-Objekt 


¥ Norden 
——= SRT siden 
Norden Westen Westen 
Nord-Nordwest 


Nord-Nordwest 


Entwicklungsumgebung Laufzeitumgebung 


Sie k6nnen das Menii bestiicken, indem Sie die Eintrége im Eigenschaftenfenster eingeben oder im Programm die 
AddRow-Methode aufrufen, bevor das Menii angezeigt wird, z.B. im Open-Handler. Sie konnen die Auswahl tiber die 
Index Eigenschaft ermitteln oder auch verandern. 


ComboBox 


Eine ComboBox kombiniert die Eigenschaften eines EditFields und eines PopupMenus. Der Benutzer kann einen vor- 
handenen Eintrag wahlen oder einen neuen Eintrag eingeben. 


Sie konnen die ComboBox genauso wie das PopupMenu befiillen. Die ListIndex-Eigenschaft gibt Auskunft tiber den aus- 
gewahlten Eintrag. Allerdings nicht dartiber, ob der Eintrag editiert wurde. Sie mtissen die Text-Eigenschaft auslesen, um 
den tatsachlichen Eintrag zu ermitteln. Der Benutzer kann iiber die Pfeiltasten das Menii aufklappen und Eintrage aus- 
wahlen. Mit der Esc-Taste wird die Auswahl abgebrochen. 


BevelButton 


Ein BevelButton-Steuerelement kann, falls entsprechend konfiguriert, als Popup-Menii fungieren. Dazu muss die Has- 
Menu-Eigenschaft auf 1 oder 2 gesetzt werden (normales Menii oder Meniti rechts). Alle Eigenschaften des BevelBut- 
ton-Steuerelements finden Sie in der REALbasic Sprachreferenz. 


Folgender Code im Open-Event des BevelButtons erzeugt das BevelButton-Meniti aus Abbildung 95: 


me.captionalign=0 //Linksbtindig 
me. hasMenu=2 //Mentii rechts 
me.caption="Plattform" 
me.addRow("Macintosh") 
me.addRow( "Windows" ) 
me.addRow("Mac OS X") 
me.addseparator 

me.addRow( "Andere" ) 


Mit der MenuValue-Eigenschaft konnen Sie feststellen, welchen Mentipunkt der Anwender ausgew4hlt hat. 
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Abb. 95: Ein BevelButton mit Popup-Menii 


Plattform [iattonmis) V Macintosh 
Windows 


Windows 
ee Mac OS X 
Andere 


Andere 


Objekte, mit denen sich Steuerelemente zusammenfassen lassen 


Wenn in einem Fenster viele verschiedene Elemente untergebracht sind, die aber nur teilweise etwas miteinander zu tun 
haben, dann kann das fiir den Benutzer sehr verwirrend sein. Daher ist es sinnvoll (und manchmal auch notwendig), 
Steuerelemente, die zusammengehGren, zu Gruppen zusammenzufassen. 


Separator 


Das Separator-Steuerelement ist eine vertikale oder horizontale Linie, die Sie in einem Fenster verwenden kénnen, um 
Objekte visuell zu organisieren. 


Abb. 96: Ein Separator-Steuerelement 


GroupBox 

Eine GroupBox kann mit oder ohne Beschriftung angezeigt werden. Befinden sich mehrere Gruppen von RadioButtons 
in einem Fenster, miissen diese jeweils in einer GroupBox zusammengefasst werden, damit die Kndpfe der einzelnen 
Gruppen unabhingig voneinander funktionieren. Unter Mac OS X 10.3 scheint die GroupBox in die Fensteroberfliche 
eingelassen zu sein. 


Abb. 97: Eine GroupBox mit und ohne Beschriftung 


Print Orientation: — Orientation —_ } 
®@ Portrait ®@ Portrait ® Portrait ® Portrait | 
Q Landscape @ Landscape © Landscape O Landscape 


TabPanel 


TabPanels werden verwendet, um mehrere Gruppen von Steuerelementen platzsparend unterzubringen. Jede Gruppe 
wird auf einer separaten Karteikarte gezeigt. Klickt der Benutzer auf einen Karteireiter, werden die derzeit angezeigten 
Steuerelemente verborgen und diejenigen angezeigt, die sich auf der angeklickten Karteikarte befinden. 


Abb. 98: Ein TabPanel mit zwei Karteireitern: 


eee Finden und Ersetzen eee Finden und Ersetzen 
i 1s 
f Finden Ersetzen | ord Finden [ Ersetzen | $e 
Suche nach. Suche nach: 


Ersetze mit: 


(Abbrechen ) Finden (Abbrechen) © Ersetzen 
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Mit dem TabPanel-Editor fiigen Sie Karteireiter hinzu und andern deren Reihenfolge und Beschriftung. Klicken Sie auf 
den letzten Tab, der immer ,,...“ heifst, um den Editor aufzurufen. 


Tab-Panel-Editor 


f > 


Finden 
Ersetzen 


Neu... 


( Andern ) 


( Abbruch ) 


Hier kdnnen Sie folgende Aktionen vornehmen: 
© Denersten Karteireiter umbenennen, indem Sie ihn selektieren und auf ,Andern‘ klicken. 
® Mit ,Neu“ einen neuen Karteireiter hinzuftigen und benennen. 


Neuer Tab-Reiter 


(Abbruch) © OK 


e Eine Karteikarte auswahlen und mit Klick auf ,L6schen“ vom Tab-Panel entfernen. 

© Die Reihenfolge der Karteireiter indern, indem Sie einen anklicken und mit den Kn6pfen ,,Rauf* und ,Runter“ an 
eine andere Position verschieben. 

Nachdem Sie die gewiinschten Karteireiter erzeugt haben, k6nnen Sie jeder Karteikarte Steuerelemente hinzuftigen. 

Selektieren Sie einen Karteireiter und draggen dann die benotigten Steuerelemente auf diese Karteikarte. Wiederholen 

Sie dies fiir jede Karteikarte. 


Mit der Facing-Eigenschaft konnen Sie die Karteireiter an jeder Kante des Steuerelements anbringen. Folgende Abbil- 
dung zeigt die Ausrichtung an der unteren Kante: 


O Portrait 


O Landscape 


Optionen Eigenschaften | 


PagePanel 


Das PagePanel entspricht von der Idee her dem TabPanel, mit dem Unterschied, dass der Anwender es nicht zu Gesicht 
bekommt. Es besitzt keine Karteireiter und hat keine sichtbare Umrandung. Lediglich die Steuerelemente auf jeder Seite 
sind sichtbar. Sie sind daftir verantwortlich, die entsprechende Methode zum Navigieren durch die Seiten zur Verfiigung 
zu stellen. Sie konnen dies dadurch erreichen, dass Sie den Wert der Value-Eigenschaft per Programmcode festlegen. In 
der IDE steuern sie das Anhangen, Einftigen, Laschen und Navigieren zwischen den Seiten eines PagePanels tiber die 
Schaltflachen am unteren Rand des Steuerelements. 


Verwenden Sie den Befehl Seite einfiigen oder Seite anhangen, um Seiten hinzuzuftigen. Oder verwenden Sie den 
Befehl Seite léschen, um die aktuelle Seite zu I6schen. 


Es gibt zwei Méglichkeiten, zwischen den Seiten zu navigieren. Der Gehe zu Seite-Befehl zeigt ein Untermenii mit allen 
zur Verfiigung stehenden Seitennummern an. Wahlen Sie aus diesem Menii eine Seitenzahl aus, um die entsprechende 
Seite direkt anzuspringen. Oder klicken Sie auf die Pfeile links und links neben der Seitenzahl, um eine Seite zuriick 
oder vor zu blattern. 
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Abb. 99: Das PagePanel-Popup-Menii (IDE) 


eee Namenlos 
. 


Bearbeiten.. 
Gehe zu Seite > 


Seite léschen 


Seite anhangen 


Der Bearbeiten-Befehl in der obigen Abbildung ruft den PagePanel-Editor auf. Der PagePanel-Editor besitzt die gleiche 
Benutzeroberfliche wie der TabPanel-Editor, mit dem einzigen Unterschied, dass Sie PagePanels keinen Namen zuord- 
nen k6énnen. Mit dieser einzigen Ausnahmen funktioniert der PagePanel-Editor genauso wie der TabPanel-Editor. 


Abb. 100: Der PagePanel-Editor 


PagePanel Editor 


Seite 0 Neu...) 
Seite 1 ————— 
Seite 2 (Loschen ) 
Seite 3 —— 
Rauf 


Runter 


Cae 


Hier ist ein einfaches Beispiel ftir den Einsatz eines PagePanel-Steuerelements. Der Benutzer mochte zwei verschiedene 
Versionen einer Benutzeroberflache anzeigen: Eine ,,Basis‘“-Version, die standardmafig angezeigt wird und eine ,,Erwei- 
terte“ Variante, die nur dann angezeigt wird, wenn der Benutzer das ausdriicklich wiinscht. Zur Kontrolle, welche Seite 
gerade angezeigt wird, dient ein Popup-Menii. 


Abb. 101: Die Seiten mit den ,,Basis”- und den ,,Erweiterten”- Einstellungen in der IDE 


eee Untitled e088 Untitled 


Basic Settings ik} Basic Settings i] 


Max. Incoming Connections: Max. Incoming Connections: 
Command Timeout (sec.): 


Data Timeout (sec.): 


aii vi> 


In der fertigen Anwendung sehen die zwei Seiten folgendermafen aus: 
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Abb. 102: Die Seiten mit den ,,Basis”- und den ,,Erweiterten”- Einstellungen im laufenden Programm 


80 Untitled 80 Untitled 


Basic Settings ay Advanced Settings ia} 


Max. Incoming Connections: | Max. Incoming Connections: 
Command Timeout (sec.): 


Data Timeout (sec.): 


Der Code im Change-Event jedes Popup-Meniis legt die Seite fest, die angezeigt werden soll, sowie die Einstellungen fiir 
das Popup-Menti der anderen Seite. Der Code des Popup-Meniis fiir die ,,Basis“-Version der Seite sieht z.B. folgender- 
mafsen aus: 


pagePanell.value=me.1istindex 
popupMenu2.1istindex=me.1listindex 


Steuerelemente zum Anzeigen von Grafik und Bildern 

Sie konnen mit REALbasic Bilder aus anderen Programmen laden und darstellen oder mit den eingebauten Funktionen 
neue Grafiken zeichnen. 

Line 

Zeichnet eine Linie in beliebiger Lange, Breite, Farbe und in beliebiger Richtung. Die Vorgabe ist 100 Pixel Lange, ein 


Pixel Breite, schwarz und waagerecht. 


Abb. 103: Ein Line-Steuerelement, das zum Trennen von zwei Bereichen in einer Dialogbox verwendet wurde 


Major Post RT Medical Events & Surgeries 


Major Medical Event: 


Site: i) Due To: 
G: i) System: 


Major Surgery: 


Objective: a) Outcome: ia} 


Notes 


Rectangle 


Zeichnet ein Rechteck beliebiger Lange, Breite, Randfarbe und Fiillfarbe. Vorgegebene Rechtecke sind 100 Pixel breit 
und hoch, haben einen schwarzen Rand und sind weifs gefiillt. Da man die Farben der Rander unabhangig voneinander 
bestimmen kann, ist es sehr leicht, Rechtecke zu erzeugen, die versenkt oder angehoben erscheinen. Ein Beispiel finden 
Sie in der Sprachreferenz. 
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Abb. 104: Ein Rectangle in Vorgabedarstellung, versenkt und angehoben 


RoundRectangle 


RoundRectangles ahneln Rectangles, haben aber abgerundete Ecken. Die Farbe des Randes kann hier aber nicht ftir die 
einzelnen Seiten bestimmt werden, da der Rand aus einer durchgezogenen Linie besteht. Dafiir kann man Breite und 
Hohe der Bégen fiir die abgerundeten Ecken bestimmen. 


Abb. 105: Ein RoundRectangle 


== 
Oval 


Zeichnet ein Oval mit einer ein Pixel starken Linie, einem schwarzen Rand und einer weifsen Innenflache. Alle diese 
Eigenschaften konnen verandert werden. Die Gro&e des Ovals wird tiber die Breite und die Hohe bestimmt. Sind diese 
gleich grofs, entsteht ein Kreis. 


Abb. 106: Ein Oval 


Canvas 


Ein Canvas (Leinwand)-Steuerelement kann dazu verwendet werden, ein Bild, das aus einer Datei geladen wurde, darzu- 
stellen, oder um mit REALbasic-eigenen Routinen eine Grafik zu zeichnen. Wenn Sie ftir Ihre Benutzeroberflache ein 
Bedienelement verwenden mochten, das nicht standardmafsig in REALbasic eingebaut ist, konnen Sie dieses ebenfalls 
iiber ein Canvas-Control und entsprechende Zeichenkommandos anlegen. Das Canvas-Steuerelement kann den Fokus 
erhalten, so dass Sie damit jedes beliebige Steuerelement, das den Fokus erhalten soll, simulieren kénnen. 


Abb. 107: Ein selbst erzeugtes Canvas-Steuerelement 


EI 


Canvas-Steuerelemente k6nnen dazu benutzt werden, ziemlich ausgefeilte eigene Steuerelemente zu erzeugen. Die 
Abbildung zeigt als Beispiel eine Tabelle mit Zeilen, die selektiert werden k6nnen und Spalten, deren Sortierung gean- 
dert werden kann, indem man den Spaltentitel anklickt. 


Abb. 108: Ein Canvas-Steuerelement fiir Fortgeschrittene 


City 
London 
Paris 
Paris 


London 
Athens 
Reykjavik 


Die beiden abgebildeten Steuerelemente wurden tibrigens von Bjorn Eiriksson entworfen. 
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ImageWell 

Das ImageWell-Steuerelement stellt einen Bereich zur Verfiigung, in dem ein PICT-Bild angezeigt werden kann. Es ist 
relativ einfach, ein ImageWell-Steuerelement so zu programmieren, dass es per Drag & Drop iibergebene Grafiken 
akzeptiert. 


Abb. 109: Ein ImageWell-Steuerelement 


Steuerelemente zum Abspielen von Filmen, Musik, Animationen 

Sofern QuickTime™ auf dem Computer des Benutzers installiert ist, kann Ihr Programm QuickTime-Filme zeigen oder 
die QuickTime-Instrumente verwenden, um Musikstiicke zu spielen. 

MoviePlayer 


Das MoviePlayer-Steuerelement zeigt einen normalen QuickTime-Movie-Player. 


Abb. 110: Das MoviePlayer-Steuerelement in der IDE und eine laufende Applikation 


eee Namenlos oe) Namenlos 


> ap 
. 


In der IDE konnen Sie einen QuickTime-Film wahlen, der diesem Element zugeordnet ist. Sie konnen das Aussehen des 
MoviePlayers selbst bestimmen. Dabei legen Sie fest, ob der MoviePlayer komplett gezeigt wird oder zunichst nur in der 
Badge-Darstellung erscheint (als kleines Icon, das nach Anklicken den eigentlichen Player zeigt) und ob alle Bedienele- 
mente des Players dargestellt werden sollen oder ob diese nicht angezeigt werden. 

Es ist sehr einfach, einem MoviePlayer-Steuerelement einen QuickTime-Film zuzuordnen. Als erstes miissen Sie den 
QuickTime-Film ins Projektfenster ziehen. Im Eigenschaftenfenster des MoviePlayer-Steuerelements, das Sie zuvor im 
Fenstereditor selektieren miissen, weisen Sie nun der Movie-Eigenschaft tiber das Movie-Popup-Menti den Film zu, wie 
in Abbildung 111 gezeigt. 


Abb. 111: So weisen Sie der Movie-Eigenschaft einen Film zu 


@ © © MonsterVision Film AutoDeactivate 


[® Fensterl = Kelns = 
iy Mena Movie: ls . 4 
{9} Beispielfilm Controller: 2 - Controller v 
Looping: [_} 
Palindrome: (} 
Projektfenster Eigenschaftenfenster 


Als nachstes kénnen Sie auf dem Fenster Stopp- und Play-Buttons anlegen und diesen mittels Objekt-Verkniipfung ent- 
sprechende Aktionen zuweisen. Gehen Sie dazu folgendermafen vor: 
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Legen Sie einen PushButton auf dem Fenster ab. Driicken Sie nun gleichzeitig die Shift- und Befehlstaste (Windows: 
Shift- und Strg-Taste) und ziehen Sie mit der Maus eine Linie vom PushButton zum MoviePlayerSteuerelement. Es 
erscheint die Dialogbox ,,Neue Verkniipfung“, in der Sie die Méglichkeit haben, eine Aktion auszuwahlen: 


Abb. 112: Verkniipfen des PushButtons mit dem MoviePlayer-Steuerelement 


Neue Verkniipfung 


Play MoviePlayer1 movie when PushButton1 gedriickt 
Stop MoviePlayer1 movie when PushButtonl gedriickt 


( Abbruch OK 


Wahlen Sie die Aktion Play MoviePlayer1 movie when PushButton1 gedriickt. Als nachstes legen Sie einen weite- 
ren PushButton auf dem Fenster an und weisen diesem die Stop MoviePlayer1 Movie-Verkntipfung zu. Als Ergebnis 
erhalten Sie den in Abbildung 110 gezeigten voll funktionsfahigen MoviePlayer. 


Der MoviePlayer und andere von Quicktime abhangige Features sind unter Linux nicht verftigbar. 


NotePlayer 


Der NotePlayer wird zwar mit einem Icon angezeigt, wenn man ihn in der Entwicklungsumgebung auf ein Fenster zieht, 
hat aber keine sichtbaren Interface-Elemente. Er wird dazu benutzt, um QuickTime-Instrumente zur Wiedergabe von 
Musik anzusteuern. Siehe NotePlayer in der Sprachreferenz. 


Der NotePlayer ist — wie QuickTime — unter Linux nicht verftigbar. 


SpriteSurface 


Mit diesem Steuerelement kann man Animationen programmieren. Wird die Run-Methode von SpriteSurface aufgeru- 
fen, werden die Meniileiste, alle Fenster und der Schreibtisch versteckt. Das gestattet der Animation, den gesamten Bild- 
schirm zu verwenden. Die Animation wird mit Hilfe sogenannter Sprites realisiert. Ein Sprite ist ein Objekt, das ein Bild 
enthalt und das tiber den Bildschirm bewegt werden kann. Das SpriteSurface-Objekt kiimmert sich automatisch um das 
Zeichnen des Hintergrundes und der Sprites und verschickt eine Nachricht, wenn zwei Sprites kollidieren. Au&Serdem 
bietet es dem Entwickler die Méglichkeit, auf Tastatureingaben des Anwenders zu reagieren. 


Eine vollstandige Liste der Eigenschaften von SpriteSurface finden Sie in der Sprachreferenz. 


RB3DSpace 


Das RB3DSpace-Steuerelement wird verwendet, um Animationen im dreidimensionalen Raum darzustellen. Es arbeitet 
in Verbindung mit den 3D-Klassen und bietet Funktionen zum Laden, Gruppieren und Manipulieren von 3D-Objekten. 
Das Basis-3D-Objekt ist von der Object3D-Klasse abgeleitet; 3D-Objekte werden dem Anwender tiber das 
RB3DSpace-Steuerelement prasentiert. 


Das RB3DSpace-Steuerelement bendtigt entweder die QuickTime3D- oder die Quesa-Bibliotheken. Wenn Sie Mac OS 
Classic verwenden, wird die Installation der QuickTime-Bibliotheken standardma&ig vorgenommen und Sie miissen 
keine gesonderte Installation durchftihren. Unter Mac OS X miissen Sie die Quesa-Bibliotheken installieren, die Sie auf 
der CD oder auf der REALbasic-Website finden. 

Um loszulegen, platzieren Sie ein RB3DSpace-Steuerelement in einem Fenster und aktivieren seine 
DebugCube-Eigenschaft. Wechseln Sie in die Laufzeitumgebung. Falls die 3D-Bibliotheken installiert sind, werden Sie 
den dreidimensionalen Raum mit den beschrifteten Koordinaten-Achsen sehen. 
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Abb. 113: Ein leerer 3D-Raum mit Koordinatensystem 


Horizontale und vertikale Achse sind x- und y-Achse. Demzufolge ist die z- Achse die Nah-/Fern-Achse. Der ,,Ursprung“ 
oder der 0,0,0-Punkt befindet sich dort, wo die Achsen aufeinandertreffen. Wenn Sie mit angeschalteter Debug- 
Cube-Eigenschaft kein Koordinatensystem sehen, sind die benotigten Bibliotheken offenbar nicht auf Ihrem Rechner 
installiert. 

Nachdem Sie sichergestellt haben, dass die bendtigten Bibliotheken vorhanden sind, konnen Sie ein Objekt in den 
3D-Raum laden und die Kamera davon wegbewegen. Um einen Eindruck davon zu bekommen, wie man 3D-Objekte 
ladt und animiert, schauen Sie sich die Beispiele fiir RB3DSpace-Steuerelemente in der Sprachreferenz an. 

Das RB3DSpace-Steuerelement wird am besten durch ein Beispiel illustriert. In folgender Abbildung wird die Position 
und der Flugpfad des Pinguins im 3D-Raum mit der Maus manipuliert. 

© Yaw- oder Links-/Rechts-Bewegungen 

© Pitch- oder Aufwarts-/Abwarts-Bewegungen 

© Roll- oder Drehungen mit oder gegen den Uhrzeigersinn. 


AuSerdem konnen Sie die Position der Kamera‘ im 3D-Raum dndern. 


Abb. 114: Ein Beispiel eines RB3DSpace Steuerelements 


The Amazing Penguin Lander! 


Weitere Informationen finden Sie in den Beispiel-Projekten auf der REALbasic-CD und in der Sprachreferenz. 
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Weitere Steuerelemente 


PopupArrow Steuerelement 


In REALbasic konnen tiber die Eigenschaft Facing sowohl die Ausrichtung als auch die Gré&e der Popup-Pfeile beein- 
flusst werden. Normalerweise wird ein PopupArrow-Steuerelement als ein Teil eines benutzerdefinierten Steuerele- 
ments verwendet. Die Ausrichtung des Pfeils zeigt an, ob das benutzerdefinierte Steuerelement zusdtzliche 
Informationen oder Optionen anzeigen kann. Abbildung 115 zeigt die méglichen Ausrichtungen. 


Abb. 115: Beispiele fiir das PopupArrow Steuerelement 


DisclosureTriangle Steuerelement 


Ein Disclosurelriangle-Steuerelement (Aufklappdreieck) wird verwendet, um hierarchische Listen anzuzeigen, wie sie 
auch in der Listendarstellung des Finders verwendet werden. Sie konnen die Ausrichtung (nach links oder rechts) und 
den Status (aufgeklappt oder nicht) beeinflussen. 

Abb. 116: Aufklappdreiecke 


LittleArrows Steuerelement 


Das LittleArrows-Steuerelement kann verwendet werden, um dem Anwender eine Schnittstelle zum Blattern (z.B. in 
einer Liste) zur Verfiigung zu stellen. Mit den zwei Methoden Up und Down konnen Sie feststellen, ob und welchen Pfeil 
der Anwender angeklickt hat. 


Abb. 117: LittleArrows Steuerelement 


g 


ChasingArrows Steuerelement 


Das ChasingArrows-Steuerelement (sich verfolgende, drehende Pfeile) geben dem Anwender eine visuelle Riickmel- 
dung, dass gerade ein zeitaufwendiger Vorgang ablauft. Die ChasingArrows werden angezeigt, indem man ihre 
Visible-Eigenschaft auf True setzt. 


Abb. 118: ChasingArrows Steuerelement 


02 


RBScript Steuerelement 
Das RBScript-Steuerelement erlaubt es dem Anwender, REALbasic-Code innerhalb einer compilierten Anwendung zu 
schreiben und auszuftihren. Solche Skripts werden in Maschinencode compiliert. 


Sie tibergeben den REALbasic-Code, den Sie ausfiihren lassen wollen, an die Source-Eigenschaft und fiihren ihn aus, 
indem Sie die Run-Methode aufrufen. Details zu den Funktionen, Kontrollstrukturen und Befehlen, die das 
RBScript-Steuerelement bietet, finden Sie in der Sprachereferenz. 
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Steuerelemente zur Kommunikation 


REALbasic bietet Steuerelemente, mit denen Ihr Programm tiber den seriellen Port (z.B. mit einem Modem oder einem 
anderen Gerit) oder tiber ein Netzwerk mit anderen Geraten per TCP/IP kommunizieren kann. 


Serial 


Das Serial-Objekt wird zwar mit einem Icon angezeigt, wenn man es in der Entwicklungsumgebung auf ein Fenster zieht, 
es hat aber keine Interface-Elemente, die der Benutzer spater sehen kann. Es wird nur dazu benutzt, den Code zur Kom- 
munikation mit der seriellen Schnittstelle auszufitihren. Weitere Informationen finden Sie bei der Beschreibung des 
Serial-Steuerelements in der Sprachreferenz. 


Da das Serial-Objekt keine Unterklasse von Control ist, kann eine Serial-Instanz auch direkt im Programmcode erzeugt 
werden. Dadurch ist es méglich, auf die serielle Schnittstelle zuzugreifen, ohne dass man das Serial-Steuerelement auf 
einem Fenster platzieren muss. 


TCPSocket 


Das TCPSocket-Objekt wird zwar mit einem Icon angezeigt, wenn man es in der Entwicklungsumgebung auf ein Fenster 
zieht, es hat aber kein eigenes Interface-Element, das der Benutzer spater sehen kann. Es wird nur dazu benutzt, um den 
Code zur Kommunikation mit anderen Computern im Intranet oder Internet auszuftihren. 


Da TCPSocket keine Unterklasse von Control ist, kann eine Socket-Instanz auch direkt im Programmcode erzeugt wer- 
den. Dadurch ist es méglich, auf TCP/P-Verbindungen zuzugreifen, ohne dass man das Socket-Steuerelement auf einem 
Fenster platzieren muss. Weitere Informationen zum Socket-Steuerelement finden Sie in der Sprachreferenz. 


Vor der Verdéffentlichung von REALbasic 5 wurde diese Funktionalitét von der Socket-Klasse tibernommen. Die 
Socket-Klasse wurde durch die TCPSocket-Klasse ersetzt und mit der Einftihrung der SSLSocket-, UDPSocket- und Ser- 
verSocket-Klassen wurden die Kommunikationsméglichkeiten weiter verbessert. Wenn in einer Ihrer bestehenden 
Anwendungen die Socket-Klasse verwendet wird, sollten Sie den Code auf die TCPSocket-Klasse umschreiben. 


SSLSocket 


Das SSLSocket-Steuerelement ist dem TCPSocket-Steuerelement sehr ahnlich. Mit SSLSocket integrieren Sie TCP/ 
[P-Kommunikation mit SSL-Verschliisselung. Es werden die SSL-Versionen 2 und 3 und TLS (Transport Layer Security) in 
der Version 1 unterstiitzt. 


SSLSocket besitzt kein eigenes Icon in der Steuerelementepalette. Da es sich nicht von der Control-Klasse ableitet, kon- 
nen Sie ein SSLSocket-Element per Code erzeugen. Sie k6nnen es auch iiber das Kontextmenti eines Fensters zu einem 
Fenster hinzuftigen. Um eine SSL-Verbindung tiber SSLSocket herzustellen, setzen Sie die Secure-Eigenschaft auf Wahr 
(TRUE) und verwenden die Connect-Methode. 


SSLSocket ist nur in der Pro-Version von REALbasic verftigbar. 


ServerSocket 


Uber die SocketServer-Klasse kénnen Sie tiber einen Port mehrere TCP/IP-Verbindungen gleichzeitig einrichten. Wird 
eine Verbindung an diesem Port aufgenommen, leitet ServerSocket diese Verbindung an einen anderen Anschluss weiter 
und widmet sich wieder dem gleichen Port. ServerSocket besitzt die Fahigkeit, die Versorgung mit TCPSockets der 
Anzahl der Verbindungen anzupassen. Aufgrund der Verz6gerung zwischen dem Eintreffen einer Verbindung, deren Wei- 
terleitung, der Erzeugung einer neuen Socket und der Wiederaufnahme des Abh6r-Prozesses, ist es ohne die ServerSo- 
cket-Klasse schwierig, eine gleichwertige Funktionalitét zu gewdhrleisten. Im Fall, dass zwei Verbindungen nahezu 
zeitgleich aufgebaut werden, kann es passieren, dass eine Verbindung fallen gelassen wird, da keine freie Socket zur Ver- 
fiigung stand. Fir weitere Informationen tiber die ServerSocket-Klasse geben Sie das Stichwort Server Socket“ in die 
elektronische Sprachreferenz ein. 
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UDPSocket 


UDPSocket unterstiitzt die Kommunikation tiber eine UDP-Verbindung (User Datagram Protocol). Das UDPSocket-Ele- 
ment besitzt kein eigenes Icon in der Steuerelementepalette, kann aber, da es sich nicht von der Control-Klasse ableitet, 
per Code erzeugt oder iiber das Kontextmenii eines Fensters eingeftigt werden. 

UDP ist die Basis fiir Hochgeschwindigkeits-Netzwerkverkehr. Es ist ein verbindungsloses Protokoll mit einem sehr klei- 
nen Overhead, ist aber nicht so sicher wie TCP. Da keine Verbindung aufgebaut werden muss, ist zur Verwendung von 
UDPSocket nicht annahernd so viel Aufwand zu treiben wie beim TCPSocket-Steuerelement. 

U 


DP Sockets k6nnen in verschiedenen Modi eingesetzen werden. Am haufigsten werden Sie zum ,,Multicasting" einge- 
setzt. Multicasting ahnelt einem Chatroom: Sie konnen den Chatroom betreten und sich mit allen anderen, die sich im 
Chatroom aufhalten, unterhalten. Fiir weitere Informationen iiber die UDPSocket-Klasse geben Sie das Stichwort 
»UDPSocket* in die elektronische Sprachreferenz ein. 


,Einfaches” Netzwerk 


REALbasic enthalt eine Version der UDP- und TCPSockets, die speziell ftir die Kommunikation mit anderen REALbasic 
Programmen entwickelt wurde. Diese Klassen heif’en EasyUDPSocket und EasyTCPSocket. Zusatzlich gibt es noch die 
Klasse AutoDiscovery, die automatisch das Netzwerk durchsucht, um weitere Computer zu finden, die tiber die 
»Easy“-Sockets kommunizieren. Werden weitere Computer gefunden, ist es recht einfach, sich gegenseitig Nachrichten 
zukommen zu lassen. 


Diese Klassen machen die Benutzung von Netzwerken recht einfach, sind aber nicht daftir ausgelegt, um mit anderen 
Applikationen, wie zum Beispiel einem HTTP-Server, zu kommunizieren. 


Weitere Informationen iiber die ,,Easy“-Klassen finden Sie im Abschnitt ,Netzwerke ganz einfach“ auf Seite 376 und in 
der Sprachreferenz. 


Das Toolbar-Objekt und das Standard Toolbar-Objekt 


Mit Hilfe des Toolbar- und des Standard Toolbar-Objekts konnen Sie in Ihren Anwendungen Toolbars (Werkzeugleisten) 
erstellen. Das Toolbar-Objekt konnen Sie mit Standard-Symbolen von Apple besetzen oder eigene Icons verwenden. 
Weitere Informationen siehe Sprachreferenz. 


Das Timer-Objekt 


Das Timer-Objekt ftihrt Programmcode in vorbestimmten Intervallen aus. Es wird zwar mit einem Icon angezeigt, wenn 
man es in der Entwicklungsumgebung auf ein Fenster zieht, hat aber keine ftir den Benutzer sichtbaren Interface-Ele- 
mente. Siehe ,,Timer-Steuerelement* in der Sprachreferenz. 


Steuerelemente fiir das Arbeiten mit Datenbanken 


Es gibt zwei Steuerelemente ftir spezielle Zwecke, die nur in Projekten relevant sind, in denen auf Datenbanken zugegrif- 
fen wird: Das DatabaseQuery- und das DataControl-Steuerelement. Ausfiihrliche Informationen zu diesen Steuerelemen- 
ten finden Sie im Kapitel ,Datenbankprogrammierung mit REALbasic“ auf Seite 334. 


DatabaseQuery 


Das DatabaseQuery-Steuerelement kann verwendet werden, um SQL-Abfragen an eine Datenbank zu richten. Dies kann 
auch tiber die REALbasic-Sprache erfolgen (ohne dass Sie das DatabaseQuery-Steuerelement tiberhaupt verwenden 
miissen). Ein DatabaseQuery-Steuerelement, das Sie einem Fenster hinzugeftigt haben, ist in der spateren Anwendung 
nicht sichtbar. 


Benutzerinteraktion tiber Steuerelemente 133 


Zur Verwendung des DatabaseQuery-Steuerelements schreiben Sie einen SQL-Ausdruck und weisen diesen der SQLQue- 
ry-Eigenschaft des Steuerelements zu. 

Das SQLQuery wird automatisch ausgefiihrt, wenn das Fenster ge6ffnet wird, auf dem sich das DatabaseQuery-Steuere- 
lement befindet. Dieses besitzt aufserdem die Methode RunQuery, mit der die Abfrage ausgefiihrt werden kann. 

Sehen Sie sich hierzu das Beispiel im Abschnitt ,,DatabaseQuery und Objektverkniipfungen* auf Seite 342 an. 


DataControl 


Das DataControl-Steuerelement ist ein ,,zusammengesetztes“ Steuerelement, das es ermdglicht, auf einfache Weise ein 
Datenbank-Frontend zu bauen. Es besteht aus vier Navigations-Kndpfen (erster Datensatz, voriger Datensatz, nachster 
Datensatz und letzter Datensatz) und der Beschriftung. 


Abb. 119: Ein DataControl-Steuerelement auf der Eingabemaske einer Adressdatenbank. 


ee8 Address Book 
First Name URL email 
Last Name a phone 
Company ae fax 
Address 
Address Cont. 
City 7 Description | 7 0 
State 
Zip 
————_—_—— a 
Country ’ 


1D ( Delete Record») ( Add Record ) 


DataControl ————¢\| ¢| Contacts > {>i 


Wenn das DataControl mit einer Datenbank und Steuerelementen, die Daten anzeigen, verkntipft wird, konnen Sie ein 
vollstandig funktionierendes Datenbankfrontend ohne weitere Programmierung erzeugen. Ein Beispiel hierzu finden Sie 
im Abschnitt ,,.Das DataControl Steuerelement* auf Seite 344. 


ActiveX Steuerelemente 


In der Windows-Version von REALbasic kénnen Sie ActiveX-Steuerelemente in die Steuerelementepalette aufnehmen. 
Ein ActiveX-Steuerelement erscheint unterhalb der Standard-Steuerelemente, verhilt es sich wie ein integraler Bestand- 
teil von REALbasic und steht Ihnen ftir Ihre Anwendungen zur Verfiigung. 
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Abb. 120: Steuerelementepalette mit ActiveX-Steuerelementen 


Steuerelemen... [%) 


ActiveX-Steuerelemente 


Um unter Windows ein ActiveX-Steuerelement auf der Steuerelementepalette zu platzieren, unternehmen Sie folgendes: 


1. Wahlen Sie Datei/ActiveX Komponenten. Daraufhin erscheint der ActiveX-Komponenten-Dialog, der alle auf 
Ihrem Computer installierten ActiveX-Steuerelemente und -Objekte anzeigt. Der Dialog enthalt die Karteikarten 


,steuerelemente* und ,,Programmierbare Objekte*. 


Abb. 121: ActiveX-Komponenten 


“ 


Komponenten 


ActionB vr Class 
ActiveMovieControl Object 
ActiveSkin.SkinForm Class 
ActiveUpdate Class 

ActiveXPlugin Object 

ActorByr Class 

Adobe Acrobat Control for ActiveX: 
Application Data Control 

Axis Control 

ColorBvr Class 

COMNSView Class 

Cr Behavior Factory 
CTreeView-Steuerungselement 
CurveE dit Control 

DHTML Edit Control for IES 
DHTML Edit Control Safe for Scripting for IES 
EffectBvr Class 


oooo0oo0ooo0o00000000 


leila 


Komponenten 


Ya Seeger soggy HN 
Steuerelemente | Programmierbare Objekte | 


&Radio 

{6BCO96B8-0CE6-11D1-BAAE -OOCO4FC2E 20D} 
{6B COS6CE-0CE6-11D1-BAAE -OOCO4FC2E20D} 
{6BCO96C8-0CE6-11D1-BAAE-DOCO4FC2E 20D} 
{6BCOS6D5-0CE6-11D1-BAAE-00CO4FC2E 20D} 
{6BC09898-0CE6-11D1-BAAE-00CO4FC2E 20D} 
{6BC09899-0CE6-11D1-BAAE-OOCO4FC2E 20D} 
{6BCO989F-0CE6-11D1-BAAE-00CO4FC2E 20D} 
{6BC09845-0CE6-11D1-BAAE-OOCO4FC2E20D} 
{6BCO9846-0CE6-11D1-BAAE-OCO4FC2E 20D} 
{6BC09847-0CE6-11D1-BAAE-OOCO4FC2E20D} 
{6BC09848-0CE6-11D1-BAAE -O0CO4FC2E20D} 
AcrolEH|prObj Class 

ActionB vr Class 

ActiveMovieControl Object 

ActiveSkin.SkinForm Class 

ActiveUpdate Class 


oooo0oo0oo0o0o00000000 


=) 
= 


Abbrechen 


2. Wahlen Sie die Steuerelemente oder programmierbaren Objekte aus, die Sie der Steuerelementepalette hinzufiigen 
wollen, und klicken Sie anschliefSend auf OK. Steuerelemente besitzen in der Regel eigene Icons. Programmierbare 
Objekte verwenden das OLEContainer-Icon. Die so hinzugefiigten ActiveX-Komponenten werden Teil des aktuellen 
Projekts, nicht aber von REALbasic selbst. Um diese ActiveX-Komponenten fiir ein anderes Projekt zu verwenden, 


miissen Sie diese Schritte wiederholen. 


Ein ActiveX-Steuerelement ldsst sich wie jedes andere Steuerelement auf einem Fenster ablegen. Draggen Sie es auf 
ein Fenster und verwenden Sie den Code-Editor, um Code ftir das ActiveX-Steuerelement zu schreiben. Fiir genauere 
Information zur Programmierung von ActiveX-Komponenten ziehen Sie bitte die Dokumentation von Microsoft zu 


Rate. Diese finden Sie in der MSDN-Bibliothek unter: http://msdn.microsoft.com/library/. 
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Abb. 122: Ein ActiveX-Regler-Steuerelement 


© Namenlos 


OLEContainer Steuerelement 


Mit dem OLEContainer-Steuerelement k6nnen Sie ActiveX-Steuerelemente in Ihre Benutzeroberfliche einbetten. 
ActiveX gibt es nur unter Windows. 
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Sobald Sie die Steuerelemente Ihrer Applikation auf einem Fenster platziert haben, k6nnen Sie ihnen im Code-Editor die 
gewitinschte Funktion geben. Beispielsweise konnen Sie festlegen, wie sich ein PushButton verhalten soll, wenn er ange- 
klickt wird, indem Sie im Action-Event des PushButtons den entsprechenden Programmcode ablegen. 


In einigen Fallen k6nnen Sie Funktionen realisieren, ohne dass Sie dafiir Programmzeilen tippen miissen. Daftir verant- 
wortlich ist ,Object Binding“, die Objektverkntipfung. 


Dank Objektverkniipfung wird eine bestimmte Aktion ausgeftihrt, wenn sich eine Eigenschaft eines Steuerelements ver- 
andert, ohne dass dafiir Programmcode vorhanden sein muss. Ein einfaches Beispiel ftir Objektverkniipfung haben wir 
bereits im Abschnitt tiber das MoviePlayer-Steuerelement auf Seite 127 prasentiert. Die zwei PushButtons ,,Play“ und 
,stop* wurden mit dem MoviePlayer-Steuerelement verkntipft. Diese Verkniipfungen spezifizierten die Funktion der 
PushButtons, es musste nirgendwo Code daftir geschrieben werden. 


Beim MoviePlayer-Beispiel handelt es sich um eine gerichtete Verkniipfung: Das Steuerelement, mit dem der Anwender 
interagiert, ist das Quellobjekt. Das Steuerelement, von dem aufgrund der Objektverbindung eine Aktion ausgeftihrt 
wird, ist das Zielobjekt. 


Um eine Objektverkniipfung herzustellen, gehen Sie folgendermafen vor: 


1. Driicken Sie die Shift- und Befehlstaste (Windows: Strg- und Shift-Taste) und ziehen Sie die Maus vom Quell- zum 
Ziel-Steuerelement (dabei erscheint eine Linie zwischen beiden Steuerelementen). 


2. Es 6ffnet sich der Dialog ,Objektverkniipfung* (Object Binding) mit einer Liste der verftigbaren Aktionen. Die in 
REALbasic fest eingebauten Objektverkniipfungen finden Sie in Tabelle 1. REALbasic kann um benutzerdefinierte 
Objektverkniipfungen erweitert werden. 


3. Wahlen Sie die gewiinschte Aktion aus und klicken Sie auf OK. 


Im Fenster erscheint eine Linie, die die beiden Steuerelemente verbindet. Wenn Sie Ihr Programm ausfiihren, arbeitet 
die Verkntipfung so, als ob Sie fiir die Aktion entsprechenden Programmcode eingegeben hatten. Die Objektverkniip- 
fungen im MoviePlayer-Beispiel sind 4quivalent zu den Programmzeilen MoviePlayerl.Play und 
MoviePlayer1.Stop, die man in den Action-Events des Play- und Stop-Knopfes hatte aufrufen konnen. 


Falls Sie einmal vergessen haben, welche Verkniipfung durch eine Linie reprasentiert wird, konnen Sie die Linie selektie- 
ren. Im Eigenschaftenfenster erscheint dann die gewahlte Aktion. Um eine Verkniipfung zu modifizieren, mtissen Sie die 
bestehende Verkniipfung zunachst Iéschen (indem Sie die Linie selektieren und Backspace driicken). Jetzt konnen Sie 
die Verkniipfung mit der gewtinschten Aktion neu anlegen. 
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Die folgende Tabelle zeigt die in REALbasic fest eingebauten Verkniipfungen: 


Tabelle 1. In REALbasic integrierte Objektverkniipfungen 


Quellobjekt 


PushButton oder 
BevelButton 


PushButton oder 
BevelButton 


PushButton oder 
BevelButton 


RadioButton 


PushButton 


BevelButton 


RadioButton 


CheckBox 


RadioButton 
RadioButton 


DatabaseQuery 


Zielobjekt 
MoviePlayer 


DataBaseQuery 
ListBox 
DatabaseQuery 


DataControl 


DataControl 


DataControl 


DataControl 


ListBox 
MoviePlayer 


PopupMenu 


Verkniipfung 


Film im MoviePlayer abspielen, wenn Knopf angeklickt wird. 
Film im MoviePlayer anhalten, wenn Knopf angeklickt wird. 


DatabaseQuery ausfiihren, wenn Knopf angeklickt wird. 


Aktiviere Knopf, wenn in der ListBox etwas selektiert wurde. 


DatabaseQuery ausfiihren, wenn RadioButton selektiert wird. 
DatabaseQuery ausfiihren, wenn RadioButton deselektiert wird. 
Fugt Datensatz ein, wenn der PushButton gedrtickt wird. 
Aktualisiert Datensatz, wenn der PushButton gedriickt wird. 
Loscht Datensatz, wenn der PushButton gedriickt wird. 

Neuer Datensatz, wenn der PushButton gedriickt wird. 

Fuigt Datensatz ein, wenn der BevelButton gedriickt wird. 
Aktualisiert Datensatz, wenn der BevelButton gedriickt wird. 
Loscht Datensatz, wenn der BevelButton gedriickt wird. 

Neuer Datensatz, wenn der BevelButton gedriickt wird. 

Fuigt Datensatz ein, wenn der RadioButton selektiert wird. 
Aktualisiert Datensatz, wenn der RadioButton selektiert wird. 
Loscht Datensatz, wenn der RadioButton selektiert wird. 
Neuer Datensatz, wenn der RadioButton selektiert wird. 

Fuigt Datensatz ein, wenn der RadioButton deselektiert wird. 
Aktualisiert Datensatz, wenn der RadioButton deselektiert wird. 
Loscht Datensatz, wenn der RadioButton deselektiert wird. 
Neuer Datensatz, wenn der RadioButton deselektiert wird. 
Fuigt Datensatz ein, wenn die CheckBox angewahlt wird. 
Aktualisiert Datensatz, wenn die CheckBox angewdhlt wird. 
Loscht Datensatz, wenn die CheckBox angewahlt wird. 

Neuer Datensatz, wenn die CheckBox angewahlt wird. 

Fuigt Datensatz ein, wenn die CheckBox abgewahlt wird. 
Aktualisiert Datensatz, wenn die CheckBox abgewadhlt wird. 
Loscht Datensatz, wenn die CheckBox abgewahlt wird. 

Neuer Datensatz, wenn die CheckBox abgewahlt wird. 
Aktiviere RadioButton, wenn in der ListBox etwas selektiert wurde. 
MoviePlayer-Film abspielen, wenn RadioButton selektiert ist. 
MoviePlayer-Film stoppen, wenn RadioButton selektiert ist. 
MoviePlayer-Film abspielen, wenn RadioButton deselektiert ist. 
MoviePlayer-Film stoppen, wenn RadioButton deselektiert ist. 
PopupMenu mit dem Ergebnis von DatabaseQuery verknipfen. 
Parameter von DatabaseQuery mit PopupMenu verknipfen. 


Parameter von DatabaseQuery mit der RowTag-Methode von PopupMenu 


verkniipfen. 


(Beispiele fiir diese Verkniipfungen finden Sie im Abschnitt ,, DatabaseQuery 


und Objektverkniipfungen” auf Seite 342.) 
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Tabelle 1. In REALbasic integrierte Objektverkniipfungen 


Quellobjekt 
DatabaseQuery 


CheckBox 
Checkbox 


Checkbox 
CheckBox 
CheckBox 
CheckBox 
CheckBox 
CheckBox 
Checkbox 


CheckBox 
CheckBox 
CheckBox 
CheckBox 
CheckBox 
Checkbox 


CheckBox 
CheckBox 
ListBox 
ListBox 
ListBox 
ListBox 
ListBox 
ListBox 
ListBox 
ListBox 
ListBox 
ListBox 


ListBox 
ListBox 


Zielobjekt 
ListBox 


NotePlayer 
DatabaseQuery 


Contextual Menu 
PopupMenu 
PopupArrow 
DisclosureTriangle 
SpriteSurface 
ImageWell 
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Verknipfung 

Verkntipfe Listbox mit dem Ergebnis von DatabaseQuery. 
Verkntipfe die Parameter von DatabaseQuery mit ListBox. 
DatabaseQuery ausfiihren, wenn ListBox den Fokus erhalt. 
DatabaseQuery ausfiihren, wenn ListBox den Fokus verliert. 


NotePlayer aktivieren, wenn Checkbox mit einem Hakchen versehen ist. 


DatabaseQuery ausfiihren, wenn Checkbox mit einem Hakchen versehen ist. 


DatabaseQuery ausfiihren, wenn Checkbox deselektiert ist. 


ContextualMenu aktivieren, wenn Checkbox mit einem Hakchen versehen ist. 


PopupMenu aktivieren, wenn Checkbox mit einem Hakchen versehen ist. 
PopupArrow aktivieren, wenn Checkbox mit einem Hakchen versehen ist. 


DisclosureTriangle aktivieren, wenn Checkbox mit einem Hakchen versehen ist. 


SpriteSurface aktivieren, wenn Checkbox mit einem Hakchen versehen ist. 
ImageWell aktivieren, wenn Checkbox mit einem Hakchen versehen ist. 
Aktiviere ListBox, wenn Checkbox mit Hakchen versehen ist. 

Aktiviere Checkbox, wenn ein ListBox-Eintrag ausgewahlt ist. 

TabPanel aktivieren, wenn CheckBox mit einem Hakchen versehen ist. 


ChasingArrows aktivieren, wenn CheckBox mit einem Hakchen versehen ist. 


Aktiviere EditField, wenn CheckBox mit Hakchen versehen ist. 
Aktiviere Canvas, wenn CheckBox mit Hakchen versehen ist. 


Aktiviere EditField, wenn CheckBox mit Hakchen versehen ist. 


MoviePlayer-Film abspielen, wenn Checkbox mit Hakchen versehen ist. 
MoviePlayer-Film stoppen, wenn Checkbox mit Hakchen versehen ist. 
MoviePlayer-Film abspielen, wenn Checkbox nicht selektiert ist. 
MoviePlayer-Film stoppen, wenn Checkbox nicht selektiert ist. 

Aktiviere MoviePlayer, wenn Checkbox mit einem Hakchen versehen ist. 


Aktiviere Slider, wenn CheckBox aktiviert. 
Aktiviere ScrollBar, wenn CheckBox aktiviert. 
LittleArrows aktivieren, wenn in ListBox ein Eintrag ausgewahlt ist. 
DisclosureTriangle aktivieren, wenn in ListBox ein Eintrag ausgewahlt ist. 
PopupMenu aktivieren, wenn in ListBox ein Eintrag ausgewdhlt ist. 
PopupArrow aktivieren, wenn in ListBox ein Eintrag ausgewahlt ist. 
ChasingArrows aktivieren, wenn in ListBox ein Eintrag ausgewahlt ist. 
ContextualMenu aktivieren, wenn in ListBox ein Eintrag ausgewahlt ist. 
ScrollBar aktivieren, wenn in ListBox ein Eintrag ausgewahlt ist. 
NotePlayer aktivieren, wenn in ListBox ein Eintrag ausgewahlt ist. 

Slider aktivieren, wenn in ListBox ein Eintrag ausgewahlt ist. 


Spielt MoviePlayer-Film, wenn die ListBox den Fokus bekommt. 
Stoppt MoviePlayer-Film, wenn die ListBox den Fokus bekommt. 
Spielt MoviePlayer-Film, wenn die ListBox den Fokus verliert. 
Stoppt MoviePlayer-Film, wenn die ListBox den Fokus verliert. 
Aktiviere MoviePlayer, wenn in der ListBox ein Eintrag gewahlt wird. 
ImageWell aktivieren, wenn in ListBox ein Eintrag ausgewahlt ist. 


Canvas aktivieren, wenn in ListBox ein Eintrag ausgewahlt ist. 
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Tabelle 1. In REALbasic integrierte Objektverkniipfungen 


Quellobjekt Zielobjekt Verkniipfung 


ListBox EditField Verknupfe EditField mit den String-Daten der ListBox (kopiert selektiertes 
Objekt in das EditField). 
Aktiviere EditField, wenn in ListBox ein Eintrag selektiert ist. 


ListBox ProgressBar ProgressBar aktivieren, wenn in ListBox ein Eintrag ausgewahlt ist. 
ListBox TabPanel TabPanel aktivieren, wenn in ListBox ein Eintrag ausgewahlk ist. 
EditField PopupMenu Verknupfe EditField mit PopupMenu (der ausgewahlte Mendeintrag wird in das 


EditField Ubernommen). 

Verknupfe EditField mit der RowTag-Methode von PopupMenu. 
Es konnen auferdem benutzerdefinierte Objektverkntipfungen programmiert werden. Mehr dazu im Abschnitt ,,Benut- 
zerdefinierte Objektverkniipfungen“ auf Seite 328. 


Andern der Steuerelementereihenfolge (Tab-Reihenfolge) 


Die Reihenfolge, in der die einzelnen Steuerelemente den Fokus zur Eingabe von der Tastatur erhalten (EditFields und 
ListBoxes), nennt man Control-Order oder auch Tab-Reihenfolge. Sie wird durch Control-Layers festgelegt, also Ebenen, 
in denen die Steuerelemente liegen. Das muss man sich so vorstellen, dass jedes Steuerelement auf einer eigenen Ebene 
liegt und diese Ebenen tibereinander gestapelt sind. Wird ein Fenster gedffnet, erhalt das Objekt, das am weitesten 
unten liegt und zur Eingabe geeignet ist, den Fokus. Sie k6nnen die Objekte auf drei verschieden Arten durch die Ebe- 
nen bewegen: 

e Verwenden Sie das Format-Menii, um die Steuerelemente durch die Ebenen zu bewegen. 

© Benutzen Sie die Dialogbox Reihenfolge. 

© Verwenden Sie das Eigenschaftenfenster. 

Das Format-Menii enthiilt Meniibefehle zum Andern der Reihenfolge der Steuerelemente. Zuerst konnen Sie sich tiber 
Format/Zeige Steuerelemente-Reihenfolge die aktuelle Reihenfolge der Steuerelemente anzeigen lassen. Dadurch 
wird an jedem Steuerelement eine Nummer eingeblendet. 


Abb. 123: Reihenfolge der Steuerelemente 
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Das Steuerelement mit der hdchsten Nummer enthalt den Fokus als erstes. Zum Andern der Reihenfolge wahlen Sie ein 
Steuerelement aus und rufen einen der folgenden Befehle aus dem Format-Menii auf: 


e Nach vorne bewegen 
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© Anden Anfang setzen 

e Nach hinten bewegen 

e Ans Ende setzen 

Dann werden die entsprechenden Markierungen der Steuerelemente auf den neuesten Stand gebracht und die neue 
aktuelle Position in der Reihenfolge der Steuerelemente wird angezeigt. 

Die Reihenfolge der Steuerelemente kann auch mit Hilfe der Dialogbox Reihenfolge verindert werden. 


Abb. 124: Die Dialogbox Reihenfolge 
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So andern Sie die Reihenfolge mit Hilfe der Dialogbox: 

1. Wahlen Sie Format/Reihenfolge. 

2. Wahlen Sie das Objekt in der Liste, dessen Tab-Position Sie andern méchten. 

3. Bewegen Sie dieses mit den Kndpfen Rauf und Runter, um die Reihenfolge zu verandern. 


Schlieflich knnen Sie auch im Eigenschaftenfenster unter Position die Position eines Steuerelements in der Steuerele- 
mentereihenfolge dndern. Sie kGnnen diesen Wert durch Eingabe eines neuen Wertes und anschlieSendes Driicken von 
Return modifizieren. 


Abb. 125: Die ControlOrder-Eigenschaft eines Steuerelements im Eigenschaftenfenster 
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Wenn Sie Format/Zeige Steuerelemente-Reihenfolge aufrufen, wahrend Sie im Eigenschaftenfenster die Reihen- 
folge der Steuerelemente ‘indern, spiegeln sich die Anderungen erst wieder, nachdem Sie im Eigenschaftenfenster einen 
neuen Wert abgespeichert haben. 


Ausrichten der Steuerelemente 


Der Interface Assistant in REALbasic erleichtert es sehr, die Positionen der einzelnen Steuerelemente an anderen Ele- 
menten auszurichten. Mit einer gepunkteten Hilfslinie und einem Raster sehen Sie sehr schnell, ob die Elemente auf 
gleicher Hohe liegen. 
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Hinweis: Ist der Interface Assistant mal im Weg, dann k6nnen Sie ihn voriibergehend ausblenden, indem Sie die Befehls- 
taste driicken, wahrend Sie ein Element bewegen. 


Zur Ausrichtung der Steuerelemente geht man so vor: 
1. Klicken Sie auf das Steuerelement, dessen Position bereits korrekt ist. 


2. Wahlen Sie Format/Ans Ende setzen, um zu gewahrleisten, dass das Steuerelement an seinem Platz bleibt, wenn 
die anderen Elemente bewegt werden. 


3. Wahlen Sie mit gedriickter Shift-Taste nacheinander alle Elemente, die Sie gemeinsam ausrichten wollen. 


4. Je nachdem, in welcher Richtung Sie die Objekte anordnen wollen, wahlen Sie unter dem Meniipunkt Objekte 
ausrichten die entsprechende Option. 


Abb. 126: Das Untermenii ,,Objekte ausrichten” 
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Um Objekte mit einem gleichmafsigen Abstand zu versehen, gehen Sie folgendermafen vor: 

1. Klicken Sie auf ein Steuerelement, um es auszuwahlen. 

2. Wahrend Sie die Shift-Taste driicken, wahlen Sie nacheinander mindestens zwei weitere Elemente. 

3. Wahlen Sie unter Objekte ausrichten die Option Horizontal ausrichten oder Vertikal ausrichten. 


Die Steuerelemente-Hierarchie 


Manchmal erzeugen Sie Teile Ihrer Benutzeroberflache, indem Sie Steuerelemente in einem anderen Steuerelement 
platzieren. So kénnen Sie z.B. das GroupBox-Steuerelement dazu verwenden, um andere Steuerelemente auszurichten, 
in der Regel RadioButtons, Checkboxen, Popup Meniis und EditFields. Auch das TabPanel und das PagePanel sind daftir 
ausgelegt, andere Steuerelemente zu beherbergen. Die Steuerelemente-Hierarchie der IDE ermdéglicht es Ihnen, mit 
Gruppen von Steuerelementen zu arbeiten. 


Ein Steuerelement, das andere Steuerelemente umfasst, wird Eltern-Steuerelement genannt. Alle Steuerelemente, die 
sich vollstandig innerhalb des Eltern-Steuerelements befinden, heifSen Kinder-Steuerelemente. Diese Zuordnung erfolgt 
automatisch, wenn Sie die Steuerelemente in folgender Reihenfolge erzeugen: Eltern — Kinder. Damit ist gemeint, dass 
Sie zuerst das Steuerelement erzeugen, das die anderen umschliefst und anschliefsend die Kinder-Steuerelemente, oder 
Sie duplizieren bestehende Kinder-Steuerelemente und platzieren sie innerhalb der Grenzen des Eltern-Steuerelements. 
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Wenn Sie auf diese Art und Weise ein Kinder-Steuerelement hinzuftigen, erhalt das Eltern-Steuerelement eine Umrah- 
mung. Diese dient als visuelle Bestatigung, dass Sie gerade ein Kinder-Steuerelement in einem Eltern-Steuerelement 


platzieren. Die folgende Abbildung zeigt, wie ein StaticText-Steuerelement als Kind in einem TabPanel platziert wird. 
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Das Eltern-Steuerelement wird auch immer dann umrahmt, wenn Sie eines seiner ,,Kinder“ mit der Maus anwahlen. In 
der folgenden Abbildung klickt der Benutzer beispielsweise auf ein StaticIext-Steuerelement. Das Eltern-Steuerelement 
(TabPanel) wird dabei ebenfalls umrahmt. 
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Uber eine Option in den Voreinstellungen des Fenstereditors konnen Sie dieses Verhalten ein- oder ausschalten. Wahlen 
Sie dazu REALbasic/Einstellungen unter Mac OS X (oder Bearbeiten/Einstellungen unter Mac OS Classic oder Win- 


dows). Wahlen Sie dann die Dialogseite Fenstereditor aus und deaktivieren bzw. aktivieren Sie Eltern-Steuerelement 
hervorheben. 
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Wenn ein Steuerelement nicht vollstandig von einem anderen Steuerelement umschlossen ist, dann ist dieses nicht 
automatisch ein Kind-Steuerelement. Es tiberlappt lediglich das andere Steuerelement. 

Wenn Sie ein Kind-Steuerelement aus einem Eltern-Steuerelement herausbewegen, dann ist dieses Steuerelement nicht 
lénger ein Kind. Wenn Sie das Steuerelement vollstandig innerhalb eines anderen Steuerelements positionieren, wird es 
zum Kind-Steuerelement dieses Steuerelements. 

Ein Eltern-Steuerelement kann einschlieflich seiner Kinder-Steuerelemente kopiert werden. REALbasic fragt dann nach, 
ob die Kinder-Steuerelemente mit kopiert werden sollen. 


Abb. 127: Nachfrage beim Kopieren eines Steuerelements mit zugeordneten Kinder-Steuerelementen 
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Steuerelemente kénnen tiber mehrere Ebenen ineinander verschachtelt sein. So konnen Sie z.B. eine GroupBox inner- 
halb eines TabPanels platzieren und anschliefend diverse RadioButtons innerhalb der GroupBox anlegen. In diesem Fall 
ist die GroupBox das Eltern-Steuerelement der RadioButtons und das TabPanel ist das Eltern-Steuerelement der Group- 
Box. Um diese Hierarchie automatisch anzulegen, mtissen Sie die Steuerelemente in der Reihenfolge ihrer Hierarchie 
erstellen: Zuerst das TabPanel, dann die GroupBox und schlieflich die RadioButtons. 


Eigenschaften der Steuerelement-Hierarchie 


Wenn Sie ein Kinder-Steuerelement duplizieren und das Duplikat im Elternobjekt belassen, ist es automatisch ein Kind. 
Wenn Sie das Duplikat jedoch aus dem Elternobjekt heraus verschieben, ist es kein Kind mehr. Ein Steuerelement muss 
sich komplett innerhalb des Elternobjekts befinden, damit es als ein Kind anerkannt wird. 


Im folgenden Beispiel zeigen beide EditFields die Identitat ihrer Eltern an. Das untere wurde aus dem oberen dupliziert, 


wurde jedoch aus dem TabPanel heraus verschoben. Es ist kein Kind mehr. 
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Wenn Sie das untere EditField wieder in das TabPanel zuriickbewegen, dann ist es wieder ein Kind des TabPanels. 


Das Verschieben eines Eltern-Steuerelements bewegt seine Kinder ebenso. Im folgenden Beispiel wurde das oben 
gezeigte TabPanel nach unten verschoben. Es nimmt das obere EditField mit sich, lasst das untere aber zurtick. 
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e Das Léschen eines Eltern-Steuerelements ldscht alle Kinder-Steuerelemente. 
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© Durch Verstecken eines Eltern-Steuerelements werden auch alle Kinder unsichtbar. Der Wert der Visible-Eigenschaft 
der Kinder bleibt dabei erhalten. 

e Das Anzeigen eines Elternobjekts zeigt auch alle Kinder an, deren Visible-Eigenschaft gesetzt ist. 

© Das Deaktivieren des Elternobjekts deaktiviert auch alle Kinder, der Wert der Enabled-Eigenschaft der Kinder bleibt 
aber erhalten. In der IDE werden durch Deaktivieren eines Containers auch alle Kinder-Steuerelemente deaktiviert, 
die Enabled-Eigenschaft wird dabei nicht aktualisiert. 

Hier sehen Sie eine deaktivierte GroupBox in der IDE mit zwei RadioButtons und zwei EditFields als Kind-Objekte. 

Wenn die GroupBox deaktiviert ist, sind alle vier Kinder deaktiviert. Da alle Kinder deaktiviert sind, wenn das Elternob- 

jekt deaktiviert ist, kann man in der Applikation die EditFields nicht ansteuern. 


Abb. 128: Eine deaktivierte GroupBox, die Ihre Kindobjekte ebenfalls deaktiviert. 
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Das Aktivieren eines Eltern-Steuerelements aktiviert nur die Kinder-Steuerelemente, deren Enabled-Eigenschaft gesetzt 
ist. Im folgenden Beispiel ist nur bei den Kinder-Steuerelementen der unteren Reihe die Enabled-Eigenschaft gesetzt. 
Obwohl die GroupBox aktiviert ist, bleiben also die Steuerelemente der oberen Reihe deaktiviert. 


Abb. 129: Ein aktiviertes GroupBox-Steuerelement 
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Wenn dieses Verhalten ftir ein Steuerelement unerwiinscht ist, konnen Sie die Steuerelemente-Hierarchie durchbre- 
chen, indem Sie im Open-Event des Fensters die Parent-Eigenschaft des Steuerelements auf Nil setzen. Dann wird sich 
das Steuerelement unabhangig von seinem friiheren Eltern-Steuerelement verhalten. 


Definieren von Mendis und Ment-Eintragen 


Der in REALbasic eingebaute Meniieditor hilft Ihnen beim Anlegen von Meniileisten, Meniis und Meniieintragen fiir ein 
Programm. 


Menileisten hinzufiigen 


Wenn Sie das erste Mal ein Desktop-Applikations-Projekt anlegen, zeigt das Projektfenster ein Fenster und eine Meniil- 
eiste mit dem Namen Meniileistel an. Das ist die Standard-Meniileiste, die automatisch ftir Ihre Applikation verwendet 
wird. Sie konnen weitere Meniileisten zu Ihrem Projekt hinzuftigen und diese einem Fenster zuordnen. Auf dem Macin- 
tosh ist es so, dass die Meniileiste des Fensters, das aktiviert wird, die aktuelle Meniileiste ersetzt. Unter Linux und Win- 
dows besitzt jedes Fenster seine eigene Meniileiste. 


Bei Windows-MDI-Applikationen wird die globale Meniileiste als Meniileiste ftir den MDI-Rahmen verwendet. Doku- 
mentfenster einer MDI-Applikation diirfen keine Meniileiste haben. Schwimmende Fenster dagegen diirfen eine Menii- 
leiste besitzen. 


Um zu Ihrem Projekt eine zusatzliche Meniileiste hinzuzufiigen, unternehmen Sie folgendes: 
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1. Bringen Sie das Projektfenster in den Vordergrund, indem Sie darauf klicken. Sollte es von anderen Fenstern ver- 
deckt sein, wahlen Sie Fenster/Projekt (Mac: 3-0 bzw. Windows: Strg-0) 


2. Wahlen Sie Ablage/Neue Menileiste. Eine neue Meniileiste erscheint im Projektfenster. 


3. Folgen Sie den Schritten im Abschnitt ,Meniis hinzufiigen“ auf Seite 144, um die Meniileiste mit Meniis und 
Meniieintragen zu versehen. 

4. Um einem Fenster eine bestimmte Meniileiste zuzuordnen, 6ffnen Sie dessen Eigenschaftenfenster. Wahlen Sie dann 
im Popup-Menii der MenuBar-Eigenschaft die gewiinschte Meniileiste aus. 


Abb. 130: Zuordnen einer Meniileiste zu einem Fenster 
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Dieses Feature ist besonders fiir Windows-Anwendungen interessant, da jedes Fenster seine eigene Meniileiste 
haben kann. Wenn Sie dieses Feature auf dem Mac einsetzen, andert sich die globale Meniileiste am oberen Bild- 
schirmrand immer dann, wenn ein Fenster mit einer anderen Meniileiste in den Vordergrund riickt. 


5. Um die globale Meniileiste zu andern, setzen Sie die MenuBar-Eigenschaft der Application-Klasse auf die gewiinschte 
Menitleiste. 


Beim Anlegen eines neuen Projekts wird diesem automatisch eine neue App-Klasse hinzugeftigt. Dabei handelt es 
sich um eine Unterklasse der Application-Klasse. Um die globale Meniileiste zu andern, miissen Sie lediglich der 
MenuBar-Eigenschaft der App-Klasse eine andere Meniileiste zuweisen. 


Abb. 131: Andern der globalen Meniileiste 
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Bei MDI-Anwendungen unter Windows ist die globale Meniileiste die des MDI-Rahmens. 


Meni hinzufiigen 


Die Vorgehensweise zum Einrichten eines Mentis und seiner Eintrége gliedert sich in 4 Schritte. Diese Schritte sind 
sowohl fiir die voreingestellte globale Meniileiste als auch fiir jede neue Meniileiste, die Sie Ihrem Projekt hinzuftigen, 
immer die gleichen. 

© Das Meniti mit dem Meniieditor anlegen. 

© Die Mentieintrige mit dem Meniieditor hinzuftigen. 
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© Den Meniieintrag aktivieren. Ein inaktiver Meniieintrag ist deaktiviert und kann nicht selektiert werden. 

e Einen Menii-Handler anlegen. Ein Menti-Handler ist eine Methode, mit der festgelegt wird, wie REALbasic auf das 
Auswahlen eines (aktivierten) Meniieintrags durch den Benutzer reagiert. Ein aktiver Mentieintrag ohne Menii-Hand- 
ler kann zwar ausgewahlt werden, es wird aber keine Aktion ausgelést. 


Es gibt zwei Moglichkeiten, einen Mentipunkt zu aktivieren. Soll der Meniieintrag durchweg aktiv sein, konnen Sie 
seine AutoEnable-Eigenschaft im Eigenschaftenfenster einschalten. Sobald Sie einen Menti-Handler hinzuftigen, ist 
der Meniieintrag funktional. Sie konnten zum Beispiel fiir den Mentieintrag Neu die AutoEnable-Eigenschaft verwen- 
den, mit dem sich ein neues Dokument in der Anwendung erzeugen lieBe. 

Soll der Meniieintrag nicht immer aktiv sein, mtissen Sie REALbasic mitteilen, wann es den Menitieintrag zu aktivieren 
hat. Es k6nnte zum Beispiel sein, dass Sie einen Mentieintrag zum Exportieren verwenden, der jedoch nur aktiv sein 
soll, wenn der Benutzer auch ein passendes Objekt zum Exportieren ausgewahlt hat. Deaktivieren Sie in diesem Fall 
die AutoEnable-Eigenschaft des Meniieintrags. Dann ist der Meniieintrag solange inaktiv, bis der Benutzer die Menii- 
zeile ansteuert. Zu diesem Zeitpunkt k6nnen Sie priifen, ob die Bedingungen zum Aktivieren des Meniieintrags 
erfiillt sind. Bei einem Meniieintrag Save miisste man zum Beispiel tiberpriifen, ob das Dokument bereits gespei- 
chert wurde oder ob seit dem letzten Speichern Anderungen vorgenommen wurden. 


Ab REALbasic Version 5 konnen Meniieintrage auch per Programmcode hinzugeftigt und entfernt werden. Weitere Infor- 
mationen dazu finden Sie in der Sprachreferenz unter dem Stichwort ,,Menultem Klasse“. 


REALbasic legt in der deutschen Version automatisch die Mentis Ablage und Bearbeiten an, wahrend die englische Ver- 

sion die Mentis File und Edit anlegt. Jedes Programm sollte zumindest tiber ein Ablage-Menii mit dem Mentipunkt 

Beenden verfiigen. Das Bearbeiten-Menti konnen Sie nur entfernen, wenn Ihr Programm keine Steuerelemente hat, die 

mittels der Mentipunkte im Bearbeiten-Menii ver’aindert werden kGnnten. Ein neues Menii entsteht so: 

1. Klicken Sie das Projektfenster an, um es in den Vordergrund zu holen. Wenn es von anderen Fenstern verdeckt sein 
sollte, klicken Sie auf Fenster/Projekt. 

2. Mit einem Doppelklick auf das Menii-Objekt 6ffnen Sie den Mentieditor. 


Abb. 132: Der Meniieditor 
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3. Klicken Sie auf das gepunktete Rechteck in der Mentileiste des Mentieditors, um es zu selektieren. 
4. Geben Sie im Eigenschaftenfenster den Namen des Meniis ein. Der Text wird daraufhin in der Meniileiste erscheinen. 


Tabelle 2. Eigenschaften des Menu-Objekts 


Name Beschreibung 

Super Die Klasse, von der das Menu-Objekt abgeleitet ist. 

Name Der interne Name des Menu, der dazu verwendet wird, es im Programmcode anzusprechen. 
Text Der Text, der in der Mentileiste erscheinen soll. 
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Abb. 133: Eigenschaftenfenster eines Menieintrags 
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Ein Hilfe-Menii anlegen 


Die meisten Mac-Anwendungen haben ein Hilfe-Menii, das sich immer ganz rechts in der Meniileiste befindet. Das min- 
deste, was sich in diesem Menii befinden sollte, sind die Mentipunkte Uber Erklarungen und Erklarungen ein. Das 
Hilfe-Menii kann auerdem Mentipunkte umfassen, die dem Benutzer Zugriff auf ,Mac Hilfe“-Dateien oder ein speziell 
fiir die Anwendung geschriebenes Hilfe-System gestatten. Ein Hilfemenii, das bereits die nétigen Mentipunkte fiir die 
Erkldrungen enthilt, erzeugen Sie so: 


1. Erzeugen Sie einen neuen Meniipunkt am Ende lhrer Meniileiste. 
2. Setzen Sie die Text-Eigenschaft auf Help. 


Das Menii wird beim Start des Programms auf einem deutschen System automatisch ,,Hilfe“ heiSen und die beiden 
Mentipunkte ,,Uber Erklirungen* und ,Erkldrungen ein‘ enthalten. Im Mentieditor erscheinen diese jedoch nicht. 


Hinzufiigen von Meniipunkten 


Meniipunkte kGnnen im Meniieditor ganz leicht in ein Menti eingefiigt werden. Ebenso lassen sich Tastaturktirzel defi- 
nieren. Denken Sie daran, dass die Tastenktirzel von links nach rechts in den Meniis zugeordnet werden. Wenn Sie die- 
selbe Taste zweimal verwenden, wird der weiter rechts gelegene Mentipunkt nicht damit angesprochen. Ferner sind 
einige Kiirzel reserviert. Nach den Apple Macintosh Human Interface Guidelines sind dies: 


Tabelle 3. Reservierte Tastenkiirzel 


Meni Tasten Befehl 

Ablage (File) 3¢-N Neu (New) 

Ablage (File) 38-0 Offnen... (Open...) 
Ablage (File) 38-W SchlieBen (Close) 

Ablage (File) 38-S Sichern (Save) 

Ablage (File) 9-P Drucken... (Print...) 
Ablage (File) #-Q Beenden (Quit) 

Bearbeiten (Edit) 3-Z Undo 

Bearbeiten (Edit) 38-X Ausschneiden (Cut) 
Bearbeiten (Edit) 3-C Kopieren (Copy) 
Bearbeiten (Edit) 3-V Einfligen (Paste) 
Bearbeiten (Edit) 3-A Alles auswahlen (Select All) 
Bearbeiten (Edit) 9¢-Punkt Abbruch eines laufenden Vorgangs 
Bearbeiten (Edit) 38-M Minimieren (Minimize) 


Einen neuen Mentipunkt erzeugen Sie so: 


1. Selektieren Sie im Mentieditor das Menii, in das der Mentipunkt eingefiigt werden soll. 
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2. Klicken Sie auf das gepunktete Rechteck am Ende des Meniis, um es zu selektieren. 


3. Im Eigenschaftenfenster geben Sie schlieflich den Text ftir den Mentipunkt ein. Der Meniieditor bietet einen 
Default-Namen an. 


4. Fiigen Sie, falls gewiinscht, einen Tastatur-Kurzbefehl hinzu, indem Sie der CommandKey-Eigenschaft einen Buchsta- 
ben zuweisen. 


5. Optional: Selektieren Sie die Eigenschaft Bold, Italic oder Underline oder fiigen Sie einen Hilfe-Text hinzu. 


Hinweis: Auch wenn der Meniieditor kleine Buchstaben fiir Tastaturktirzel gestattet, sollten dennoch grof§e Buchstaben 
verwendet werden. 


Wenn Sie die alt-Taste im Tastaturktirzel verwenden mochten, fiigen Sie ,option“ bei der Command-Key-Eigenschaft 
hinzu. ,option-F* legt z.B. die Tastenkombination $8-alt-F als Tastatur-Kurzbefehl fest. 


Folgende Abbildung zeigt einen Seitenumbruch-Meniieintrag, der dem Spezial-Menii hinzugefiigt wurde. 


Abb. 134: Ein neuer Meniieintrag im Spezial-Menti 


e808 Anwendungs-Menii is) Eigenschaften 
: ~@ Ablage Bearbeiten Spezial [| 
Seitenumbruch 


Name: SpezialSeitenumbruch 
Index: 


—_——| Super: Menultem aa 
Text: Seitenumbruch (a) 

Bold: (1) 

Italic: 7) 

Underline: (} 
BalloonHelp: a) 
DisabledBalloont... @ 

CommandKey: 
SubMenu: [| 


Das Mac OS X-Programm-Ment 


Mac OS X-Programme haben standardmafig ein Menii links vom Ablage-Menii. Es erhalt automatisch den Namen der 
Applikation. Wenn Sie Ihre Applikation in der Entwicklungsumgebung von REALbasic testen, heisst der Mentipunkt 
REALbasic. Wenn Sie ein eigenstindig lauffahiges Mac OS X-Programm erzeugen, bekommt das Menti den Namen, den 
Sie im Dialog ,,Applikation erzeugen“ bei ,Mac OS-Programmeinstellungen“ eingegeben haben. 


Der Menieintrag ,,Beenden” 


Der Meniieintrag ,Beenden“, der bei Mac OS Classic-Anwendungen im Ablage-Menii erscheint, befindet sich unter 
Mac OS X am Ende des Applikations-Meniis. Automatisch hinzugefiigt werden Mentieintrage fiir das Ein- und Ausblen- 
den der aktuellen Applikation und ein ,,Alle einblenden“ Meniieintrag. 

Im Mentieditor wird der Beenden-Meniieintrag immer im Ablage-Menii angezeigt. Wenn das Programm unter Mac OS X 
gestartet wird, wandert er automatisch ins Applikations-Menti. Das Ablage-Menii bleibt unter Mac OS X so lange deakti- 
viert, bis Sie ihm einen Meniieintrag hinzuftigen. 

Dem Applikations-Menii fiigen Sie einen Mentieintrag hinzu, indem Sie diesen im Apfel-Menii des Meniieditors unter- 
bringen. Wenn die Applikation fiir Mac OS Classic compiliert wird, erscheinen diese Mentipunkte im Apfel-Menii. 

In folgender Abbildung wird ein ,,Uber...“-Meniieintrag dem Applikations-Menii in Mac OS X und dem Apfel-Menii im 
Classic Mac OS hinzugefiigt. 
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Abb. 135: Hinzufiigen eines ,,Uber Meine App”-Meniipunkts ins Applikationsmenii (Mac OS X) bzw. ins Apfel-Menii (Mac OS Classic). 


@ © © Anwendungs-Menii © Eigenschaften 


r oc ~ | 
Abl Bearbeiten Spezial 
Bae Seen Pez = Name: AppleUeberMeineApp 
Uber Meine App = 


| Super: Menultem wv 


Text: Uber Meine App 
Bold: } 
Italic: 


Underline: 
BalloonHelp: (a) 
DisabledBalloonti... (e) 
CommandKey: 
SubMenu: [| 


Hinzufiigen eines ,,Einstellungen”-Menteintrags 


Unter Mac OS X befindet sich der ,,Einstellungen“-Mentipunkt standardmafig im Menii der Applikation. Unter anderen 
Betriebssystemen erscheint er aber im ,,Ablage-“, ,,Bearbeiten-“ oder ,,Datei-“ Menii. 


Wie kann man nun einen Mentipunkt an zwei Stellen gleichzeitig unterbringen? Dies ist recht einfach. Erstellen Sie den 
,Einstellungen“-Mentieintrag in dem Menii, das Sie ftir Ihre Windows- und Mac OS Classic-Version verwenden wollen. 


Im Eigenschaftenfenster des Mentieintrags stellen Sie den Wert der SuperClass-Eigenschaft von Menultem auf 
PrefsMenultem. Jeder Meniipunkt, der von PrefsMenultem abgeleitet ist, wird unter Mac OS X automatisch unter 
dem Applikations-Menii einsortiert (oder unter dem REALbasic-Menii, wenn die Applikation in der IDE léuft), verbleibt 
unter Windows und Classic Mac OS aber an der Stelle, an der Sie ihn eingesetzt haben. Der Einstellungen-Meniipunkt 
in der folgenden Abbildung erscheint unter Windows und unter Mac OS Classic im Datei-Meniti, unter Mac OS X aber im 
Applikations-Menii. 


Abb. 136: Einer Applikation den Meniipunkt ,,Einstellungen” hinzufiigen 


2 ee Menu is] Eigenschaften 
@ File Edit [| o® 


Name: FileEinstellungen 
Index: 
Super: PrefsMenuttem v 


Sichern Text: Einstellungen... e 
Sichern als... Bold: { 
Italic: { 


Einstellungen... 38, -. Underline: [ 
7 BalloonHelp 
Beenden #Q DisabledBalloonH... 
Verhaten sss 


CommandkKey: , 
SubMenu: (_) 
AutoEnable: 


oo 


Wenn Sie auerdem einen ,,Uber dieses Programm*-Mentipunkt hinzugefiigt haben, erscheint dieser als erster Menii- 
punkt im Programm-Menii, gefolgt vom Einstellungen-Mentipunkt. 


Gemafs der Apple-Richtlinien ftir die Mac OS X-Benutzeroberflache sollten Sie ,3¢ ,“ (88-Komma) als Tastaturktirzel ftir 
den Einstellungen-Mentipunkt verwenden. 


Untermeniis anlegen 


Untermeniis sind Mentipunkte, bei deren Auswahl ein Menti nach rechts ausklappt. Der Mentipunkt selbst kann nicht 
ausgewahlt werden. Er dient nur als Titel fiir das Untermenii. 

Ein Untermenii wird wie folgt angelegt: 

1. Klicken Sie im Mentieditor auf den Mentipunkt, der das Untermenii beherbergen soll. 
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2. Im Eigenschaftenfenster kreuzen Sie die Eigenschaft Submenu“ an. Ein neues Untermenti-Objekt erscheint im 
Meniieditor. 


3. Im Meniieditor klicken Sie auf das gepunktete Rechteck, das rechts neben dem Mentipunkt neu aufgetaucht ist. 
4. Im Eigenschaftenfenster geben Sie den Namen fiir den Untermeniipunkt ein. 


Untermentis bieten dem Benutzer einen schnellen Zugriff auf eine Gruppe von Mentipunkten. Allerdings kénnen sie 
einen Computer-Neuling verwirren, da sie den direkten Blick auf einzelne Mentipunkte versperren. Durchsucht ein 
Benutzer die Meniis nach einem bestimmten Meniipunkt, sieht er sich méglicherweise die Untermentis nicht an. Uber- 
legen Sie sich genau, an welche Zielgruppe Sie sich mit Ihrem Programm wenden, bevor Sie Untermeniis einsetzen. Soll- 
ten es in der Mehrzahl ungetibte Benutzer sein, dann sollten Sie die Wahlméglichkeiten eher in einer Dialogbox 
unterbringen als in einem Untermenii. 

Untermentipunkte konnen selbst auch wieder ein Untermenii enthalten. Aber auch hier gilt, dass damit Funktionen des 
Programms versteckt werden und es méglicherweise zu kompliziert wird, in verschachtelten Mentis nach dem richtigen 
Kommando zu suchen. 


Verschieben von Ment und Meniipunkten 


Ein Mentipunkt kann durch Ziehen mit der Maus an eine andere Position im Menti verschoben werden. Mentipunkte 
konnen aber nur innerhalb desselben Meniis verschoben werden. Wenn der Meniipunkt in ein anderes Menti wandern 
soll, dann miissen Sie ihn léschen und in dem anderen Menii neu eingeben. 


Sie konnen auch Meniis innerhalb der Meniizeile verschieben. Draggen Sie das Menii in der Meniileiste nach links oder 
rechts, ein vertikaler Balken zeigt die Position des Mentis an. 


Loschen eines Meniipunkts 


Einen Mentipunkt k6nnen Sie ldschen, indem Sie ihn anklicken und die Backspace-Taste driicken. 


Einfiigen einer Trennlinie 


Man verwendet Trennlinien, um Meniipunkte optisch zu Gruppen zusammenzufassen. Um eine Trennlinie einzuftigen, 
legt man einen Mentipunkt an und tippt in die Text-Eigenschaft einfach ein Minus (,-"). 


Arrays aus Ment-Eintragen 


In manchen Fallen konnen Sie die Meniipunkte nicht im Voraus bestimmen, da sich diese je nach Kontext oder Umge- 
bung dndern, in der das Programm lduft. Ein Beispiel hierfiir ist das Font-Menii, das normalerweise in jedem Programm 
vorhanden ist, das Text mit Stilinformationen unterstiitzt. Der Programmierer wei vorher nicht, welche Fonts auf dem 
Rechner des Anwenders installiert sind. 


Erzeugen Sie das Menii. Erzeugen Sie einen Menii-Eintrag, geben ihm einen Namen und setzen seine Index-Eigenschaft 
auf 0, um ein Array aus Meniieintrdgen zu erzeugen. Dann miissen Sie den Code schreiben, der das Array mit den 
Namen der Fonts fiillt, die auf dem Rechner des Anwenders installiert sind. Vorausgesetzt, dass keine Fonts installiert 
oder entfernt werden, so lange das Programm Iduft, reicht es, die Font-Liste einmal beim Programmstart aufzubauen. 


Platzieren Sie dazu den Code in den Open-Event-Handler der Application-Klasse. Dieser wird ausgeftihrt, wenn das Pro- 
gramm gestartet wird. Das App-Objekt, das automatisch fiir Ihr Projekt erzeugt wird, ist der richtige Ort daftir. 
Folgender Code fiillt das Font-Menii, wenn das Programm gestartet wird. Es verwendet die eingebaute Font-Funktion, 
die den Namen des i.ten Fonts auf dem Rechner des Anwenders liefert. 


Dim i, nFonts as Integer 
nFonts=FontCount-1 
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//baue Font-Menti auf 
FontFontName(0).text=Font(0) 

For i=1 to nFonts 

m=New FontFontName //erzeugt neuen Menti-Eintrag 
m.Text=Font(i)//liefert Namen des i.ten Fonts 
Next 


Apple Macintosh User Interface Guidelines 


Wenn Sie ein Programm nicht ftir den Eigenbedarf, sondern fiir andere Anwender entwickeln, sollten Sie sich unbedingt 
ausreichend Zeit fiir das Design der Benutzeroberflache nehmen. Diese entscheidet dartiber, wie gern und wie effektiv 
man Thr Programm einsetzen wird. Falls ein Anwender nicht binnen 15 Minuten ein Erfolgserlebnis mit Ihrer Software 
hat, wird er sich frustriert abwenden und versuchen, sein Problem anderweitig zu lsen. 


Ein Programm wirkt um so professioneller, je durchdachter seine Benutzeroberflache ist. Dabei ist es ftir den Anwender 
sehr hilfreich, wenn er fiir die Benutzung [hres Programms auf Fertigkeiten zuriickgreifen kann, die er bei der Verwen- 
dung anderer Produkte erlangt hat. 


Der REALbasic Interface Assistant™ hilft Ihnen, eine professionelle Benutzeroberflache zu gestalten. Wenn Sie ein Steu- 
erelement in die Nahe eines Fensterrandes draggen, zeigt Ihnen REALbasic eine Hilfslinie an, die Ihnen vermittelt, wie 
weit Sie das Steuerelemente draggen diirfen. Diese Linie erscheint 20 Pixel vor dem rechten, linken und unteren Rand 
des Fensters und 14 Pixel vor dem oberen Rand. Wenn Sie ein Steuerelement auf ein anderes Steuerelement zubewegen, 
zeigt REALbasic eine Linie im Abstand von 12 Pixeln (der empfohlene Abstand zwischen zwei Steuerelementen) an. 


Es ist etwas vollig anderes, ein Programm zu benutzen, als die Benutzeroberfliche eines Programms zu gestalten. Wenn 
Sie es noch nicht getan haben, sollten Sie sich einmal die Macintosh Human Interface Guidelines ansehen. Hier wird 
genau beschrieben, warum die Macintosh-Benutzeroberflache so realisiert wurde, wie wir sie kennen. Wenn Sie sich an 
diese Vorgaben halten, wird Ihr Programm ftir jeden mit dem Mac vertrauten Anwender einfach zu benutzen sein. 


Die Macintosh Human Interface Guidelines finden Sie im Internet unter www.devworld.apple.com. 
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capita Programmierung in BASIC 


In diesem Kapitel lernen Sie, wie BASIC aufgebaut ist und welche Unterschiede es zwischen REALbasic und BASIC gibt. 


Inhalt 


e Datentypen 

e Ablegen von Werten in Eigenschaften und Variablen und Konstanten 
e Ausfiihren von Instruktionen in Methoden 

© Mehrfaches Ausfiihren von Instruktionen in Schleifen 

@ Verzweigen 


BASIC versus REALbasic 


BASIC wurde um 1960 erfunden, um Leuten das Programmieren beizubringen. Alles, was Programmieren zu kompliziert 
macht, wurde aus BASIC entfernt. Das hatte zur Folge, dass BASIC lange Zeit als ungeeignet fiir komplexe Programme 
galt, was allerdings weniger an der Sprache selbst lag, als vielmehr an den Implementierungen, die existierten. 


Friihere Implementierungen von BASIC verwendeten einen Interpreter, der jede Instruktion des Programms las und 
ausfiihrte. Das bedeutet, dass jedesmal, wenn das Programm lief, Zeile fiir Zeile iibersetzt und ausgefiihrt wurde, so wie 
es ein Simultandolmetscher im wirklichen Leben tun wiirde. Fiir andere Sprachen existierten bereits Compiler, die das 
Programm in Maschinencode tibersetzen und abspeichern. Das hat den Vorteil, dass solche Programme zur Ausftihrung 
nicht mehr iibersetzt werden mtissen. Das macht die Sache natiirlich schon erheblich schneller. 


REALbasic hat einen eingebauten Compiler. Das bedeutet, dass der von REALbasic erzeugte Code so schnell wie nur 
moglich ausgeftihrt wird. REALbasic ist eine moderne objektorientierte Sprache. Wenn Sie erst mit dem Programmieren 
anfangen, dann sagt Ihnen das jetzt nicht viel, aber Sie werden schon noch herausfinden, was das bedeutet. REALbasic 
verbindet die einfache Benutzbarkeit von BASIC mit modernen Programmierkonzepten und erlaubt so, auf einfache 
Weise sehr leistungsfahige Programme zu schreiben. Dabei ist es nicht notig, im einzelnen zu wissen, wie das Betriebs- 
system genau funktioniert. Daher ist es einfacher, ein Programm zu schreiben und dartiber hinaus kann man auch Pro- 
gramme schreiben, die unter Umst’anden auf ganz anderen Betriebssystemen funktionieren, da sie nichts enthalten, was 
nur auf einem bestimmten Betriebssystem funktioniert. 


Ablegen von Werten in Eigenschaften und Variablen 


Sollen Informationen auf einem Computer permanent gespeichert werden, dann sichert man sie in einem Dokument 
auf der Festplatte. In einem Programm ist es oft nétig, Informationen nur vortibergehend im Speicher abzulegen. Sie 
konnen sich das als Ansammlung von Schubladen vorstellen. Jede dieser Schubladen ist irgendwo im Speicher und um 
sie voneinander unterscheiden zu kénnen und den Inhalt wiederzufinden, bekommt jede Schublade einen Namen, was 
schon besser ist als eine Speicheradresse, denn das ware nur eine Zahl. Je nachdem, wie man diese Speicherplatze nutzt, 
nennt man sie Variablen oder Eigenschaften (Properties). 


Was sind Eigenschaften? 


Variablen, die Werte speichern, die ein Objekt — zum Beispiel ein Fenster — beschreiben, nennt man Eigenschaften (Pro- 
perties). Der Titel im Titelbalken des Fensters, seine Breite oder seine Héhe werden in Eigenschaften des Fensters 
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gespeichert. Wenn ein Fenster ge6ffnet wird, dann werden diese Eigenschaften in den Speicher kopiert. Sie konnen sie 
iiber ihren Namen erreichen. Dadurch kénnen Sie die Daten, die in den Eigenschaften abgelegt sind, auslesen oder 
andere Werte hineinschreiben. Wollen Sie beispielsweise, dass sich der Titel eines Fensters andert, wenn der Benutzer 
einen Knopf anklickt, schreiben Sie in die Eigenschaft ,Title“ des Fensters einen anderen Wert. Jede Eigenschaft kann 
eine bestimmte Art von Daten enthalten. Manche speichern Text, so wie die Eigenschaft Title“ eines Fensters, andere 
speichern Zahlen, so wie beispielsweise die Eigenschaft Width“, die die Breite des Fensters angibt. 


Variablen 


Manchmal kommt es vor, dass Sie einen Wert speichern wollen, der nicht direkt zu einem Objekt gehort. Dafiir benutzen 
Sie Variablen. Eine Variable ist so etwas wie eine Eigenschaft, nur dass sie keinem Objekt zugeordnet ist. 


Datentypen 


Um leistungsstarke Kommandos verwenden zu konnen und Zeit bei der Ausfiihrung des Programmcodes zu sparen, 
muss ein Computer bestimmte Annahmen tiber die Beschaffenheit der Daten, die man verwendet, machen. Er muss wis- 
sen, ob es sich bei der Information, die er vorgesetzt bekommt, um eine Zahl, ein Datum, einen Text etc. handelt. Ohne 
eine Information tiber den Datentyp k6nnte 1 plus 1 im Ergebnis 2 sein, wenn es sich um eine Zahl handelt oder auch 
,11“ als String (Zeichenkette), wenn es sich um Zeichen handelt, die man so hintereinander hangt. REALbasic versteht 
sehr viele Datentypen, aber sechs sind ganz besonders wichtig: String, Integer, Single, Double, Boolean und Color. 


String 

Ein String ist eine Reihe von Buchstaben, also eine Zeichenkette. Jede Information ldsst sich im Prinzip als String spei- 
chern. “Jeanette”, “12.06.1968”, “45.90” kdnnen Strings sein. Sie denken jetzt vielleicht ,Moment mal, die letzten beiden 
sind doch ein Datum und eine Zahl, aber keine Zeichenkette“, aber sie sind es schon, wenn man sie im Programmtext in 
Anfiihrungszeichen setzt. Die maximale Lange eines Strings ist nur vom Speicher begrenzt, der zur Verftigung steht. 
Zwei Strings konnen mit dem ,,+“-Zeichen zu einem verbunden werden. “Big” +”Dog” ergibt also “BigDog”. Das war 
dann aber schon die gesamte ,Mathematik", die Strings erméglichen. Alles andere, was man mit Strings anstellen kann, 
wird mit anderen Funktionen gemacht. 


Integer 


Ein Integer ist eine ganze Zahl zwischen etwa -2 Milliarden und +2 Milliarden. In anderen Programmiersprachen wiirde 
man dies als Long Integer bezeichnen. Weil es sich um Zahlen handelt, kann man mit Integer-Werten rechnen. Sie wer- 
den nicht in Anfiihrungszeichen gesetzt und belegen 4 Bytes im Speicher. 


Single 


Ein Single ist eine Zahl, die auch Dezimalstellen haben darf. Es gibt keine Beschrankung des Wertes. In anderen Spra- 
chen wire dies eine Single Precision Real Number. Mit Singles kann man rechnen und sie belegen 4 Bytes im Speicher. 


Double 


Ein Double ist eine Zahl, die auch Dezimalstellen haben darf. Es gibt keine Beschrankung des Wertes. In anderen Spra- 
chen wire dies eine Double Precision Real Number. Mit Doubles kann man rechnen und sie belegen 8 Bytes im Speicher. 
Da Doubles mehr Dezimalstellen verwenden, um eine Zahl zu reprdsentieren, sollten Sie diese verwenden, wenn die 
zusatzliche Genauigkeit fiir Ihre Berechnungen wichtig ist. Berechnungen mit Singles sind jedoch sowohl auf dem 
Macintosh als auch unter Windows schneller als mit Doubles. 


Datentyp Kleinster Wert GroBter Wert 
Integer -2147483648 2147483647 
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Datentyp Kleinster Wert Gr6Bter Wert 

Single 1.175494 e-38 3.402823 e+38 

Double 2.2250738585072013 e-308 1.797693 1348623157 e+308 
Boolean 


Ein Boolean kann entweder den Wert ,True“ (wahr) oder False“ (falsch) annehmen. Boolean-Variablen enthalten 
zundchst den Wert ,,False“, k6nnen aber mit der True-Funktion auf den Wert ,True“ gesetzt werden. Einige Objekte 
haben Eigenschaften vom Typ Boolean. Beispielsweise haben viele Objekte die Eigenschaft Enabled“, die ein 
boole’scher Wert ist. 


Color 


Ein Color speichert den Wert einer REALbasic-Farbe. Ein Color-Wert besteht aus drei Komponenten und kann unter Ver- 
wendung dreier Farbmodelle eingestellt werden (RGB, HSV oder CMY). Da jede Komponente als ein Byte gespeichert 
wird, kann sie einen Wert zwischen 0-255 annehmen. 


Mit folgenden Funktionen kann ein Color-Wert gesetzt werden. 


Funktion = Farbmodell Datentyp und Wertebereich der Parameter 
RGB Red-Green-Blue (Rot-Grtin-Blau) Integer (0-255) 

HSV Hue-Saturation-Value (Farbton-Sattigung-Helligkeit) Double (0-1) 

CMY Cyan-Magenta-Yellow (Cyan-Magenta-Gelb) Double (0-1) 


Folgender Programmcode weist der fillcolor-Eigenschaft eines Rechtecks eine Farbe zu: 
rectanglel.fillcolor=CMY(.35,.9,.6) 

Ein RGB-Farbwert kann auch so zugewiesen werden: 

&CRRGGBB 

RRGGBB geben dabei jeweils in Hexadezimaldarstellung die rote, griine und blaue Komponente an. Jede Komponente 
kann also einen Wert von 00 bis FF annehmen. 

Beispiel: rectangle. fil1Color=&cFF594A 

Die drei Color-Funktionen kénnen gegeneinander ausgetauscht werden. Nachdem Sie eine Farbe zugewiesen haben, 
kOnnen Sie jede Ihrer neun Eigenschaften auslesen. Folgendes Beispiel liefert den Red-Farbanteil und kann verwendet 
werden, auch wenn zum Zuweisen der Farbe das CMY-Modell verwendet wurde: 


Dim redValue as integer 

edValue=rectanglel.fillcolor.red 

Farben konnen auch in der Farbpalette definiert werden. Klicken Sie auf ein freies Feld der Farbpalette, um die Farbaus- 
wahl anzuzeigen und eine Farbe auszuwahlen. Die in der Farbpalette abgelegten Farben konnen Sie bequem per Drag & 
Drop zuweisen: Ziehen Sie einfach eine Farbe auf eine beliebige Eigenschaft im Eigenschaftenfenster, die einen Farbwert 
erwartet. Es ist aufS{erdem méeglich, eine Farbe aus der Farbpalette in den Code-Editor zu ziehen. In diesem Fall wird der 
RGB-Wert im ,,&c‘-Format an der Cursorposition eingefiigt. 
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Variant 


Ein Variant ist ein spezieller Datentyp, der den Wert jedes beliebigen Datentyps, inklusive Objekten, speichern kann. Die 
Methode des Variant-Typs liefert einen Integer-Wert, anhand dessen man den Datentyp des enthaltenen Wertes bestim- 
men kann. 


Von Type gelieferter Wert Beschreibung 

Nil 

Integer 

Double oder Single 
String 

Object 

11 Boolean 

16 Color 


oO oumny oO 


Abhangig vom Datentyp des Wertes, den der Variant enthilt, konnen Sie eine der folgenden Eigenschaften dazu verwen- 
den, den Wert in einen anderen Datentyp umzuwandeln. 


Eigenschaft Beschreibung 

BooleanValue —_Liefert den Wert des Variant als ein Boolean. 
ColorValue Liefert den Wert des Variant als ein Color. 
DoubleValue Liefert den Wert des Variant als ein Double. 
IntegerValue Liefert den Wert des Variant als ein Integer. 


ObjectValue Liefert den Wert des Variant als ein Object. 


StringValue Liefert den Wert des Variant als ein String. 


Auch wenn Sie Datum- und Datum-/Uhrzeit-Werte in einem Date-Objekt speichern, ist dies kein Datentyp. Tatsachlich ist 
Date eine Klasse. Lesen Sie hierzu auch den Abschnitt ,Objekte deklarieren“ auf Seite 157. 


Andern eines Datentyps 


Es kommt oft vor, dass man einen Wert von einem Datentyp in einen anderen umwandeln muss. Das ist normalerweise 
deswegen so, weil man den Wert mit etwas verkniipfen mochte, das von einer Funktion kommt, die einen anderen 
Datentyp verwendet. Beispielsweise kann es sein, dass die Anzahl der Fenster gezahlt wird, was naturgemaf mit einer 
Zahl geschieht, die Nummer des Fensters aber im Titel angezeigt werden soll, was in der Title-Eigenschaft geschehen 
muss, die aber ihrerseits eine Zeichenkette ist. Daher erhalten Sie eine Fehlermeldung, wenn Sie versuchen, dem Fens- 
tertitel die Zahl zuzuweisen. Die Fehlermeldung weist darauf hin, dass die beiden Datentypen unterschiedlich, sprich 
nicht kompatibel sind. Daher muss man die Zahl zuerst in einen String umwandeln, bevor man sie zuweisen kann. 


Fiir diesen Zweck gibt es die Str-Funktion (Str steht ftir String), die eine Zahl in einen String wandeln kann. Siehe 
,otr-Funktion“ in der Sprachreferenz. Umgekehrt kann man aus einem String eine Zahl machen, indem man die 
Val-Funktion verwendet (Val steht ftir Value (Wert)). Siehe Val-Funktion“ in der Sprachreferenz. 


Zuweisung fir Eigenschaften 


Die Syntax ftir solche Zuweisungen ist im allgemeinen: 


objectName. propertyName=value 
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Haben Sie einen PushButton, der pushbutton! heifst und Sie méchten, dass die Beschriftung ,OK“ sein soll, dann miis- 
sen Sie der Caption-Eigenschaft den String ,OK“ zuweisen. Das geht so: 


pushbuttonl.caption="0K" 


Dies konnen Sie lesen wie ,,andere den Beschriftungstext fiir pushbuttonl auf OK“. Diese Syntax gilt, wenn Sie eine 
Eigenschaft eines Steuerelements im gleichen Fenster 4ndern mochten. Wenn ein Steuerelement in einem Fenster eine 
Eigenschaft eines Objektes in einem anderen Fenster dndern soll, dann miissen Sie den Namen des Fensters (nicht den 
Inhalt seiner Title-Eigenschaft, das sind zwei verschiedene Dinge!) mit einbeziehen. Angenommen, es werden zwei Fens- 
ter benutzt und das eine heifst window1, das andere window2. Nun soll ein PushButton, der in window] liegt, die 
Beschriftung von pushbutton1 in window2 dndern. Die Syntax lautet in diesem Fall: 
window2.pushbuttonl.caption="0K" 


Wiirden Sie den Namen des Fensters window2 nicht angeben, dann miisste REALbasic annehmen, dass Sie ein Objekt 
namens pushbutton! in window1 meinen, da dies das Fenster ist, in dem das Objekt liegt, das den Programmcode ent- 
halt, der gerade ausgeftihrt wird. Wenn Sie allerdings mehr als eine Kopie des Fensters (window2) verwenden wiirden, 
das das zu andernde Objekt enthalt, dann funktioniert diese Methode nicht. Wie Sie in solchen Fallen vorgehen k6nnen, 
kommt spater noch. 

Soll eine Eigenschaft des Fensters selbst geandert werden, muss der Name des Fensters nicht angegeben werden. Wenn 
ein PushButton den Namen des Fensters dndern soll, in dem er sich selbst befindet, dann ist folgende Zuweisung notig: 
title="Hello World" 

In manchen Fallen sind Eigenschaften hierarchisch gruppiert. Das beste Beispiel hierfiir ist das Canvas-Steuerelement. 
Dieses ist mit einem Set von Zeichenwerkzeugen ausgestattet, das es erlaubt, das Aussehen frei zu gestalten. Alle Zei- 
chenwerkzeuge sind tiber die Graphics-Eigenschaft erreichbar. Folgende Zeile z.B. zeichnet ein Rechteck der Grofse 
100*50 an den Koordination 0,0 von Canvas 1: 

Canvasl.Graphics.DrawRect 0,0,100,50 

DrawRect ist eine Methode, die zur Graphics-Klasse gehért und nicht zur Canvas-Klasse. Die Graphics-Eigenschaft der 
Canvas-Klasse erlaubt es Ihnen jedoch, auf diese zuzugreifen. 


Me und Self 


REALbasic kennt zwei sehr niitzliche Befehle, Me und Se/f. Me verweist auf das Steuerelement, mit dem Sie arbeiten. 
Wenn Sie z.B. die Caption-Eigenschaft von PushButton1 in einem der Event-Handler dieses Steuerelements auf ,OK“ set- 
zen mochten, kénnen Sie eine der folgenden Schreibweisen verwenden: 

pushbuttonl.caption="0K” 

oder 

le. caption="0K” 

Der Vorteil bei der Verwendung von Me ist, dass Ihr Code universeller wird. Sie konnen ihn bei jedem anderen PushBut- 
ton-Steuerelement ohne Anderung einsetzen. 

Der Befehl Se/f verweist auf das Elternfenster des Steuerelements. Sie k6nnen ihn in einem Event-Handler fiir jedes Steu- 
erelement eines Fensters verwenden. Folgende Zeilen sind aquivalent: 


FindDialog.title”’Find” 
Self .Title="Find” 
Title="Find” 


Im ersten Beispiel wird die Name-Eigenschaft des Fensters verwendet; im zweiten Beispiel erreicht der Se//-Befehl das 
gleiche, ohne den Namen des Fensters explizit verwenden zu miissen. Das letzte Beispiel nutzt die Tatsache aus, dass 
das Elternfenster verwendet wird, wenn Sie den Code in einem Steuerelement innerhalb des Fensters verwenden. 
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Werte aus Eigenschaften auslesen 


Sie konnen den Wert einer Eigenschaft fast genauso auslesen, wie Sie Werte zuweisen. Dazu muss nur auf der linke Seite 
des Gleichheitszeichens bestimmt werden, wohin der Wert tibernommen werden soll, wahrend auf der rechten Seite die 
Eigenschaft des Objekts steht, deren Wert ausgelesen werden soll. Soll beispielsweise einer Variablen X die Cap- 
tion-Eigenschaft des pushbutton1 zugewiesen werden, so sieht die Syntax dazu so aus: 

x=pushbuttonl.caption 


Ebenso funktioniert es, wenn Sie den Wert einer Eigenschaft eines Objektes in einem anderen Fenster auslesen wollen 
(analog zum oben geschilderten Fall): 
x=window2.pushbuttonl.caption 


Eine Eigenschaft des Fensters, in dem sich das Objekt befindet, dessen Code ausgefiihrt wird, kann so ausgelesen wer- 
den: 

x=title 

Auch hier muss der Name des Fensters dann nicht explizit angegeben werden. 


Werte in Variablen 


Wenn Werte gespeichert werden sollen, die nichts mit Eigenschaften von Objekten zu tun haben, dann verwenden Sie 
Variablen. Eine Variable ist ein Bereich im Speicher, dem Sie einen Namen geben. Den Namen wahlen Sie so, dass er eine 
Aussage tiber die Funktion der Variable liefert. Wenn Sie das Alter einer Person in Tagen seit ihrer Geburt berechnen wol- 
len, wiirden Sie eine Variable verwenden, die Sie ,,Tage“ nennen. Variablen kinnen Namen beliebiger Lange haben. Die 
Namen miissen aber mit einem Buchstaben anfangen, wobei auch Umlaute verwendet werden diirfen. Ansonsten sind 
folgende Zeichen gestattet: A-Z, a-z, 0-9 und der Unterstrich (,,_“). Variablennamen sind nicht case-sensitiv. Das bedeu- 
tet, dass zwischen Grofsbuchstaben und Kleinbuchstaben kein Unterschied besteht. x und X ist fiir REALbasic dieselbe 
Variable. 


Sie konnen Werte in Variablen speichern und aus Variablen auslesen, so wie das auch bei Eigenschaften méglich ist. Um 
einen Wert auszulesen, muss die Variable auf der rechten Seite des Gleichheitszeichens (=) stehen. Soll die Beschrif- 
tung eines Knopfes auf den Inhalt einer Variablen namens ,,buttonTitle“ gesetzt werden, dann schreibt man das so: 
PushButtonl.Caption=buttonTitle 

Als erstes legen Sie die Variable an und weisen ihr einen Datentyp zu. Wie auch die eingebauten Objekt-Eigenschaften 
haben Variablen einen Datentyp. Bevor Sie eine Variable einsetzen, muss ihr Datentyp mit dem Dim-Ausdruck bekannt 
gegeben werden. Dim ist die Abkiirzung fiir Dimension. Der Ausdruck zielt darauf ab, Platz fiir die Variable zu schaffen. 
Alle Ihre Dim-Ausdrticke miissen innerhalb einer Methode vor den ersten Code-Zeilen erscheinen. Sobald der Datentyp 
einer Variable einmal deklariert ist, verbleibt die Variable fiir die Laufzeit der Methode im Speicher. 


In diesem Beispiel wiirden Sie folgenden Ausdruck verwenden: 


Dim buttonTitle as String 

Damit wird die Variable buttonTitle im Speicher angelegt und REALbasic wird vermittelt, dass die Variable nur 
String-Werte speichern kann. Es kann allerdings nur ein String gespeichert werden, nicht mehrere. Nachdem Sie die 
Variable erstellt haben, geben Sie ihr einen Wert und weisen Ihren Wert einer anderen Variable oder Eigenschaft zu. So 
k6nnen Sie zum Beispiel schreiben: 

buttonTitle="Save” 

Nachdem Sie der Variable einen Wert zugewiesen haben, kénnen Sie diesen der Eigenschaft eines bestehenden Objekts 
zuordnen. Das heifst, dass Sie die Variable einer Eigenschaft vom Typ String zuordnen k6nnen. 

Dies wird im folgenden Beispiel erreicht: 

Pushbuttonl.Caption=buttonTitle 
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Soll umgekehrt der Wert, der in der Caption-Eigenschaft des Knopfes steht, in einer Variablen gespeichert werden, dann 
schreibt man das so: 


buttonTitle=pushButton1l.Caption 

Im folgenden Beispiel wird i als Variable vom Typ Integer deklariert: 

Dim i as integer 

Wenn mehrere Variablen vom gleichen Typ deklariert werden sollen, dann kann man das in einem Aufwasch tun: 
Dim i,j,k as integer 

Dim Name,Adresse as String, Schuhgroesse as Single 

Wenn Sie eine Variable mit der Dim-Answeisung deklarieren, kGnnen Sie dieser auch einen Wert zuweisen. Dazu geben 
Sie nach dem Datentyp ein Gleichheitszeichen und einen Wert an. Die folgenden Ausdriicke sind giiltig: 

Dim i as Integer = 3 

Dim Name as String = “Igor”, Adresse as String = “Baumallee 15” 

Sie konnen dies auch mischen, wie folgender Ausdruck zeigt: 

Dim a as Integer, b as Integer = 15 


Mit diesem Ausdruck wird die Variable a als Integer deklariert, erhalt jedoch keinen Wert, wahrend b den Wert 15 zuge- 
wiesen bekommt. 


Auch der folgende Ausdruck ist giiltig: 
Dim a,b,c as Integer = 15 


Mit diesem Ausdruck werden a,b und c als Integer deklariert und bekommen den Wert 15 zugewiesen. Auch wenn dies 
eine giiltige Zuweisung ist, sollten Sie mit Zuweisungen fiir mehrere Variablen in einem Dim-Ausdruck vorsichtig umge- 
hen, da man schnell den Uberblick verliert. 


So wie bei Eigenschaften, kann man nur kompatible Datentypen einander zuweisen. Folgendes Beispiel fthrt zu einem 
Fehler: 

Dim x, z as integer 

Dim y as string 

x=1 

y="Hello" 

Z=xt+y 

x ist eine Zahl, y aber eine Zeichenkette. Da verschiedene Datentypen nicht addiert werden konnen, kommt es zu einer 
Fehlermeldung. 


Objekte deklarieren 


Sie kennen bereits die Datentypen Integer, String, Boolean, Single, Double und Color. Variablen konnen aber auch mit 
bestimmten Objekttypen deklariert werden. Zum Beispiel gibt es ein REALbasic-Objekt namens Date, das Sie verwen- 
den, wenn Sie ein Datum oder eine Uhrzeit speichern wollen. 

Technisch gesehen ist Date eine REALbasic-Klasse. Den Klassen ist ein eigenes Kapitel gewidmet, in dem Sie mehr darii- 
ber erfahren. 

Wenn Sie eine Date-Variable verwenden wollen, wird die eingebaute Klasse als Vorlage verwendet. Eine solche Vorlage 
ietet genug Platz, um die Eigenschaften des Objekts und in manchen Fallen auch die Methoden zu speichern, die zu 
einem Objekt der Klasse gehoren. 


Sie erzeugen eine Instanz dieser Vorlage, die Sie dann verwenden kénnen. Die Instanz ist die Variable, die Sie in Ihrem 
Code benutzen. Die Klasse selbst k6nnen Sie nicht benutzen, da diese als Vorlagen ftir Instanzen dient. Objekte einer 
Klasse werden instanziiert, weshalb man bei einem Objekt auch immer eine Instanz einer Klasse meint. 
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Die Date-Klasse, zum Beispiel, besitzt Eigenschaften fiir das Jahr, den Monat, den Tag, Minuten und Sekunden. Zusatz- 
lich besitzt sie Eigenschaften, die das Datum formatieren, wie ShortDate (kurzes Datum), AbbreviatedDate (abgektirztes 
Datum) oder LongDate (langes Datum). 

Eine neue Variable dieses Typs erzeugen Sie wie jede andere Variable auch. 

Dim Geburtsdatum as Date 

Dieser Ausdruck hat allerdings noch keine Instanz der Date-Klasse erzeugt. Der folgende Ausdruck wiirde also nicht 
funktionieren: 


Dim Geburtsdatum as Date 
Geburtsdatum.Year = 1996 


Bevor Sie auf Eigenschaften der Date-Variablen zugreifen k6nnen, mtissen Sie mit Hilfe des New-Operators eine Instanz 
erzeugen. Sprich, ein Objekt der Klasse Date instanziieren: 


Dim Geburtstag as Date 
Geburtstag = New Date 


Nun kénnen Sie auf die Eigenschaften der Date-Variable zugreifen, zum Beispiel ein anderes Datum setzen: 


Dim Geburtstag as Date 
Geburtstag=New Date 
Geburtstag. Year=1996 
Geburtstag.Month=6 
Geburtstag.Day=23 


Wenn Sie nun die ShortDate Eigenschaft auslesen, hatte diese den Wert “6/23/96”. Es gibt eine noch eine kiirzere Syntax, 
um die Deklaration und Instanziierung zusammenzufassen: 


Dim Geburtstag as New Date 
Geburtstag.Year = 1996 
Geburtstag.Month = 6 
Geburtstag.Day = 23 


Wenn Sie die Instanzierung auslassen, wird der REALbasic-Compiler eine Fehlermeldung ausgeben, wenn Sie auf eine 
Eigenschaft der Variable zugreifen oder eine Methode aufrufen. 


Verwenden von Arrays 

Mit der Dim-Anweisung kénnen auch Arrays angelegt werden. Ein Array ist eine Variable, in der man mehrere Werte des 
gleichen Typs speichern kann, die als Elemente bezeichnet werden. 

Ein Array wird angelegt, indem man in Klammern den Index des letzten Elements im Array angibt. Die Anzahl der Werte, 
die man im Array ablegen kann, ist tatsachlich allerdings um eins grofer als die Anzahl, die man bei der Dim-Anweisung 
angibt. REALbasic legt namlich nullbasierte Arrays an, die immer ein Element mit der Nummer 0 enthalten. 

Die Anweisung: 

Dim aNames (10) as string 

legt ein String-Array mit elf Elementen an. 

Die Anweisung: 

Dim aNames(0) as string 

legt einen String-Array mit einem Element an, Element Null. Sie kGnnen auf dieses Element genau so wie auf jedes 
andere Element mit einem positiven Index lesend und schreibend zugreifen. 


Wenn Ihnen die Gréfse des Arrays zum Zeitpunkt der Deklaration nicht bekannt ist, konnen Sie ein sogenanntes 
Null-Array deklarieren. Ein Null-Array ist ein Array, das keine Elemente enthilt. Dazu geben Sie bei der Deklaration einen 
Index von -1 an oder lassen den Index weg. 
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Die Anweisungen 

Dim Vornamen(-1) as String 

oder 

Dim Vornamen() as String 

erzeugen ein Array, das keine Elemente enthalt. Sie k6nnen die Gréfe zu einem spateren Zeitpunkt mit Hilfe der 
ReDim-Anweisung andern oder das Array mit der Append-Methode ,wachsen‘ lassen. 


Sie konnen auch mehrdimensionale Arrays mit REALbasic anlegen. Die maximale Anzahl an Dimensionen in einem mul- 
tidimensionalen Array betragt 20. Um ein mehrdimensionales Array anzulegen, miissen Sie fiir jede Dimension eine 
Indexnummer angeben. 


Die Anweisung 

Dim aNames (2,10) as string 

egt zum Beispiel ein Array mit drei Zeilen und elf Spalten an. 

Sie konnen in Dim-Befehlen globale Konstanten verwenden, um die Grofse eines Arrays festzulegen. Folgende Deklara- 
tion verweist auf die globale Konstante ,nLanguages“, die in einem Modul definiert wurde: 


Dim aControl(10,nLanguages) as String 


nLanguages ist die Anzahl der vom Programm unterstiitzten Sprachen und wird an vielen Stellen im Programm verwen- 
det. Wenn sich etwas dndert, miissen Sie nur ihre Definition im Modul andern. Weitere Informationen finden Sie im 
Abschnitt ,,Einfiigen von Konstanten in ein Modul" auf Seite 232. 


Ein einzelnes Element eines Arrays wird mit der Nummer angesprochen, die seinen Platz im Array definiert. Hier wird in 
der ersten Spalte der ersten Zeile des Arrays der Name ,,Frank“ abgelegt: 


aNames(0,0)="Frank" 


Die Ubound-Funktion liefert den Index des letzten Elements in einem eindimensionalen Array. Die Anzahl der Elemente 
ist um eins groer als die ausgegebene Zahl, da das Array ein ,,nulltes“ Element besitzt. Bei einem mehrdimensionalen 
Array liefert Ubound den Index des letzten Elements der Dimension, die Sie daftir festlegen. Wenn Sie keine Dimension 
angeben, wird der entsprechende Wert der ersten Dimension ausgegeben. Die erste Dimension trigt die Nummer 1. 
Das folgende Beispiel ergibt fiir die Variable i den Wert 5 und fiir die Variable j den Wert 3. 

Dim i,j as integer 

Dim aNames(5,3) as string 


j=Ubound(aNames ) 
j=Ubound(aNames ,2) 


Arrays initialisieren 


Nachdem Sie ein Array deklariert haben, k6nnen Sie ihm initiale Werte zuweisen. Dies konnen Sie mit der Array-Funk- 
tion oder auch mit der individuellen Zuweisung der Elemente, wie im Beispiel gezeigt: 

Dim Namen(2) as String 

//separate Zuweisungen 

Namen(0)="Fred" 

Namen(1)="Ginger" 

Namen(2)="Stanley" 

Im folgenden Beispiel wird die Array-Funktion verwendet, um genau dasselbe zu erreichen. In diesem Beispiel muss die 
Gr6Be des Arrays nicht angeben werden. Die Array-Funktion fiigt die Elemente selbst’ndig dem Array hinzu: 

Dim Namen(-1) as String 

Namen=Array("Fred", "Ginger", "Stanley") 

Wenn Sie das Array mit einer fixen Grose deklarieren, aber nicht geniigend Parameter angeben, um alle Elemente zu fiil- 
len, beginnt die Array-Funktion mit dem Element Null und fiillt die folgenden Elemente mit den angegebenen Werten. 
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Array-Zuweisungen 


Zwei Arrays mit kompatiblen Datentypen kénnen einander zugewiesen werden. Hier ist ein Beispiel: 


Dim NamenA(2),NamenB(2) as String 

NamenA=Array("Fred", "Ginger", "Stanley") 

NamenB=NamenA 

Dieser Ausdruck weist den ersten drei Elementen in NamenB die Werte von NamenA zu. Wiirde NamenB weniger Ele- 
mente besitzen als NamenA, wiirden zusatzliche Elemente hinzugeftigt werden, damit alle Elemente von NamenA einem 
Element in NamenB zugewiesen werden kdnnen. Ein Beispiel: 

Dim NamenA(3),NamenB(2) as String 

NamenA(0)="Fred" 

NamenA(1)="Ginger" 

NamenA(2)="Tommy" 

NamenA(3)="Woody" 

NamenB=NamenA 

Nach der Ausftihrung dieses Codes hat NamenB vier Elemente statt vorher drei, um auch den Wert Woody“ aufnehmen 
zu k6nnen. 


Die GroBe von Arrays anpassen 
Mehrere Befehle sind fiir die Anpassung der Gré&e von Arrays verantwortlich: 


© Append: Append fiigt dem Array ein Element hinzu und vergr68ert die Anzahl der Elemente im Array um die Zahl 1. 
Wenn Sie Append aufrufen, tibergeben Sie den Wert, den Sie dem Array hinzuftigen wollen. Die Anweisung: 
aNames.Append “Dave” 
fiigt dem Array aNames ein Element hinzu und setzt den Wert fiir dieses Element auf den String ,,Dave". 

Append lasst sich nur auf eindimensionale Arrays anwenden. 

© Insert: Die Insert-Methode ftigt dem Array ein neues Element an der von Ihnen definierten Stelle hinzu. Insert ben6- 
tigt daftir zwei Parameter: den Index des Elements, das eingefiigt werden soll und den Wert des neuen Elements. 
Zum Beispiel: 
aNames.Insert 9,”Hal” 

Nach der Ausfiihrung diese Befehls ware ,,Hal“ der Wert ftir aNames(9). Das alte Element (9) ware um einen Index 
nach oben an die Stelle von Element (10) gewandert usw. Genauso wie durch den Befehl Append vergréfert sich die 
Anzahl der Elemente im Array um die Zahl 1. 

Insert asst sich ebenfalls nur auf eindimensionale Arrays anwenden. 

© Remove: Die Remove-Methode léscht das Element mit dem angegebenen Index. Die Anweisung: 
aNames.Remove 9 
loscht das Element mit Index 9, verringert die Anzahl der Elemente im Array um die Zahl 1. Alle Elemente, die dem 
geloschten Element folgen, riicken um eine Stelle nach unten. Diese Methode lasst sich ebenfalls nur auf eindimen- 
sionale Arrays anwenden. 

© Redim: Die Redim-Methode verindert die Gréfe eines bestehenden Arrays. Ubergeben Sie Redim die neue Anzahl 
der Array-Elemente. Der Datentyp wurde schon durch die Dim-Anweisung bestimmt. Die Anweisung: 

Redim aNames(100) 

vergrofsert das Array auf 101 Elemente. Redim ldsst sich sowohl auf eindimensionale als auch auf mehrdimensionale 
Arrays anwenden. Bei mehrdimensionalen Arrays konnen Sie nur bereits bestehende Dimensionen in ihrer Grofe 
variieren. Dimensionen konnen nicht hinzugefiigt oder geléscht werden. 


Ein Unterschied zwischen Dim und Redim besteht darin, dass Dim nur Integer oder globale Konstanten als Werte 
akzeptiert, wahrend Redim alle Ausdriicke toleriert, die einen Integer-Wert ergeben. Das kann zum Beispiel eine 
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benutzerdefinierte Funktion sein, die einen Integer-Wert ergibt. Damit k6nnen Sie die Grofse Ihres Arrays im Verlaufe 
einer Anwendung dynamisch gestalten. 


Konvertieren zwischen Array und Variable 


Es gibt zwei Funktionen, um ein Array in eine Variablen zu konvertieren oder aus dem Inhalt eines Strings ein Array zu 
erzeugen. 


© Split: Der Split-Funktion wird ein String tibergeben, der in ein eindimensionales Array konvertiert wird. Dies 
geschieht, indem der String an einem anzugebenen Trennzeichen zerteilt wird. Das voreingestellte Trennzeichen ist 
ein Leerzeichen. Hier ein Beispiel, bei dem das Komma als Trennzeichen verwendet wird: 
Dim aNames(-1) as String //Die Split-Funktion dndert die GréBe 
Dim s as String 
s="Juliet,Taylor,Casting" 
aNames=Split(s,",") 
Nach dem Aufruf von Split besitzt aNames drei Elemente. 
aNames(0)="Juliet" 
aNames(1)="Taylor" 
aNames(2)="Casting" 

© Join: Die Join-Funktion erzeugt aus einem eindimensionalen Array einen String. Dabei kann ein Trennzeichen ange- 
geben werden, das im String zwischen die einzelnen Array-Elemente gesetzt werden soll. Voreingestellt ist das Leer- 
zeichen. Im folgenden Beispiel geht es um ein Array, das Vor- und Nachnamen und die Telefonnummer einer Person 
enthalt. Mit Hilfe der Join-Funktion kénnen Sie daraus einen String erzeugen, der all diese Informationen enthilkt. 
Dim aNames(2) as String 
Dim s as String 
aNames(0)="Anthony" 
aNames(1)="Aardvark" 
aNames(2)="737-8946" 
s=Join(aNames,",") 


Dieser Programmcode liefert in der Variablen s den String "Anthony, Aardvark 737-8946". 
Wiirde der Aufruf folgendermafen lauten: 

s=Join(aNames ) 

Dann ware das Ergebnis ein String mit dem Inhalt "Anthony Aardvark 737-8946". 


Dictionaries 


Unter einem Dictionary (Wo6rterbuch) versteht man ein REALbasic-Objekt, das aus einer Liste von ,,Schliissel — 
Wert‘-Paaren besteht. Das besondere an Dictionaries ist, dass sowohl der ,,Schltissel“ als auch der dazugehorige Wert 
dem Datentyp Variant angehoren. Dies bedeutet, dass ein Dictionary Werte von verschiedenen Datentypen enthalten 
kann und der ,,Schliissel“ nicht zwingend ein Integer-Wert sein muss. Sie k6nnen in einem Dictionary einen Wert abfra- 
gen, indem Sie entweder tiber den ,,Schliissel“ darauf zugreifen oder die Position des Wertes in der Reihenfolge der Ein- 
trage angeben. Der Sprachreferenzeintrag zum Thema Dictionaries zeigt ein interessantes Beispiel, in dem Farben die 
Funktion des ,,Schltissels“ tibernehmen. 
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Mathematische Operatoren 


Mathematische Berechnungen kommen bei der Programmierung haufig vor. REALbasic kennt die tiblichen mathemati- 
schen Operationen: 


Operation Operator Beispiel 
Addition + 24+3=5 
Subtraktion - 3-2=1 
Multiplikation ss 3*2=6 
Flie8kommadivision / 6/4=1.5 
Integer-Division \ 6\4=1 
Modulo Mod 6 Mod 3 =0 
6 Mod 4 = 2 


Es gibt auSerdem noch eine Menge mathematischer Funktionen, die Sie in der Sprachreferenz finden. 


REALbasic verwendet die tibliche mathematische Ausfiihrungsfolge. Geklammerte Elemente werden zuerst berechnet. 
REALbasic beginnt mit der Bearbeitung der Elemente, die innerhalb der gr6ften Anzahl von Klammern stehen (also 
sozusagen von innen nach aufsen). Danach erfolgen Multiplikationen oder Divisionen von links nach rechts und am 
Schluss Additionen und Subtraktionen. Die folgenden Gleichungen liefern alle unterschiedliche Werte, da die Klammern 
unterschiedlich gesetzt wurden: 


Gleichung Ergebnis 
24+3%*(5+3) 26 
(2+3)*5+3 28 
2+(3*5)+3 20 
Konstanten 


Eine Konstante ist eine Variable, die einen festen Wert enthalt. Dieser Wert kann nicht nachtraglich verandert werden, 
sondern wird beim Erzeugen der Konstante zugewiesen. Das Erzeugen von Array-Konstanten ist nicht moglich. 


In REALbasic konnen Sie Konstanten fiir Fenster, Module und Objekte erzeugen, die Sie Ihrem Projekt hinzugeftigt 
haben (Fenster, Module und Klassen werden spater in diesem Handbuch behandelt). Sie konnen auch lokale Konstan- 
ten in einer Methode erzeugen. 

Jede Konstante hat einen Giiltigkeitsbereich (Scope). Dieser Giiltigkeitsbereich legt fest, welcher Teil des Programms auf 
die Konstante zugreifen kann. Wenn Sie eine Konstante in einer Methode erzeugen, kann nur innerhalb dieser Methode 
auf sie zugegriffen werden. Der Giiltigkeitsbereich beschrinkt sich also auf diese Methode, andere Teile der Applikation 
kennen die Konstante nicht. Wenn eine andere Methode, eine Konstante mit gleichem Namen erzeugt, so ist dies eine 
vollig andere Konstante. Die Konstanten stehen in keiner Beziehung, da ihr Giiltigkeitsbereich sich auf die jeweilige 
Methode beschrankt. 

Um eine lokale Konstante zu erzeugen, verwenden Sie die Const-Answeisung und eine Zuweisung. 

Const <EineKonstante> = <Wert> 

Sie brauchen fiir eine Konstante keinen Typ anzugeben, wie Sie es bei einer Dim-Anweisung tun miissten. Der folgende 
Ausdruck ist giiltig: 

Const BackGroundColor=&cff0000 
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REALbasic erkennt, dass es sich um eine Konstante des Typs Color handelt. Sie konnen nun die Konstante Background- 
Color jeder Variable oder Eigenschaft zuweisen, die ebenfalls vom Typ Color ist. Ein Beispiel: 


Const Accept="0K" 
bevelbutton1l.caption=Accept 


Wenn die Applikation gestartet wird, ist die Beschriftung des Buttons “OK”. 


Konstanten eines Fensters, eines Moduls oder einer Klasse haben mehrere mogliche Giiltigkeitsbereiche. 


© Global (nur fiir Modulkonstanten sinnvoll): Auf eine globale Konstante kann innerhalb des gesamten Projekts zuge- 
griffen werden. Globale Konstanten k6nnen die Pflege eines Projekts stark vereinfachen, wenn alle an einer zentralen 
Stelle deklariert werden. Wenn Sie dann eine Konstante andern miissen, wissen Sie sofort, wo sie deklariert ist und 
dass sich die Anderung auf das gesamte Projekt auswirken wird. 


Globale Konstanten sind ein praktisches Werkzeug, wenn Sie mehrere Sprachversionen Ihres Projekts erzeugen wol- 
len. Mehr dazu finden Sie im Abschnitt ,Lokalisieren mit Konstanten“ auf Seite 234. 

© Offentlich: Die Konstante kann innerhalb des gesamten Projekts verwendet werden. Um die Konstante innerhalb 
des Objekts zu verwenden, das die Konstante ,,besitzt“, greifen Sie tiber die Bezeichnung auf diese zu, wie bei einer 
globalen Konstante. 
Um eine 6ffentliche Konstante aus einem anderen Objekt heraus zu verwenden, miissen Sie die Punkt-Notation ver- 
wenden, also ,,Objektname.Konstantenname“. Nehmen wir an, es gibt ein Fenster mit dem Namen ,,SaveChangesWin- 
dow“, welches eine 6ffentliche Konstante ,,Accept“ besitzt. In den Methoden und im EventHandler des Fensters 
wiirden Sie die Konstante einfach tiber deren Bezeichnung verwenden. Wenn Sie sie aber in einer Methode, die nicht 
zu dem Fenster geh6rt, verwenden wollen, miissen Sie “SaveChangesWindow.Accept” schreiben. 

© Geschiitzt: Geschiitzte Konstanten kénnen nur in den Objekten verwendet werden, fiir die sie erzeugt wurden. 
Wenn Sie beispielsweise eine geschiitzte Konstante fiir ein Fenster erzeugen, konnen Sie diese nur innerhalb der 
Methoden und EventHandler dieses Fensters und seiner Steuerelemente verwenden. Der Zugriff erfolgt tiber den 
Namen des Konstanten. 

© Privat: Eine private Konstante ist einer geschiitzten Konstante sehr ahnlich. Allerdings kann diese nur in Code ver- 
wendet werden, der direkt zu dem Objekt gehGrt. Sie kann nicht in Objekten verwendet werden, die von dem Objekt 
abgeleitet worden sind. Der Zugriff erfolgt tiber den Namen der Konstanten. 


Konstanten kénnen nur im Fenster des Code-Editors erzeugt werden. Weiterhin konnen Konstanten nur fiir Fenster, 
Module und Klassen erzeugt werden. Konstanten werden nicht im Projektfenster abgelegt. 


Wenn Sie beispielsweise fiir das Standardfenster ,,Fenster1“ eine Konstante erzeugen mochten, 6ffnen Sie den Code-Edi- 
tor und fiihren folgende Schritte aus: 


© Wahlen Sie den Meniipunkt Neu/Neue Konstante. Daraufhin erscheint ein Dialog. 

© Bestimmen Sie den Namen, den Typ und den Wert. 

e Wahlen Sie einen Giiltigkeitsbereich aus. 
Fiir Fenster haben Sie die Wahl zwischen Offentlich, Geschiitzt und Privat. 
Die Liste unter dem PopupMenu enthilt Konstanten ftir die Lokalisierung Ihrer Applikation. Sie konnen fiir die ver- 
schiedenen Sprachen unterschiedliche Werte festlegen, sogar fiir unterschiedliche Plattformen. Lesen Sie dazu auch 
den Abschnitt ,,Eine Konstante einem Modul hinzuftigen“ auf Seite 232. 

© Klicken Sie auf ,OK“, um die Konstante zu speichern. 
Jetzt k6nnen Sie die Konstante unter Berticksichtigung ihres Giiltigkeitsbereichs in Ihrem Projekt verwenden. Sie 
konnen sogar im Eigenschaftenfenster diese Konstante einer Eigenschaft zuweisen, indem Sie als Wert fiir die Eigen- 
schaft ein Nummernzeichen (,,#“) gefolgt vom Namen der Konstanten verwenden. Falls Sie dieser Konstanten in 
Abhingigkeit von Sprache und Plattform verschiedene Werte zugewiesen haben, werden beim Erzeugen des ausfiihr- 
baren Programms automatisch die zu den Compiler-Einstellungen passenden Werte eingesetzt. 
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Reservierte Worter 


Die folgenden Schltisselworter k6nnen nicht als Variablennamen verwendet werden, da sie schon Teil REALbasic-Spra- 
che sind: 


Tabelle 4. Reservierte Worter 


And Elself Loop Select 
Array End e Self 
As Event Mod Shared 
Boolean Exception odule Single 
ByRef Exit amespace Static 
ByVal False ew Step 
Call Finally ext String 
Case For il Sub 
Catch Function ot Then 
Class GoTo Object To 
Color Handles Of True 
Const f Or Try 
DebugPrint mplements Private Until 
Declare n Protected Wend 
Dim nherits Public While 
Do nline68Kk Raise #bad 
Double nteger Redim #else 
Downto nterface Rem #endif 
Each sa Return #if 
Else Lib Return #pragma 


Ausfiihren von Instruktionen in Methoden 


Eine Methode besteht aus einer oder mehreren Anweisungen, die ausgefiihrt werden, um ein bestimmtes Resultat zu 
erreichen. REALbasic kennt viele eingebaute Methoden. Beispielsweise fiihrt der Aufruf der Methode ,Quit“ dazu, dass 
Thr Programm sich beendet. Einige Objekttypen (Klassen) haben eingebaute Methoden. Beispielsweise hat die Klasse 
ListBox eine Methode namens AddRow, die zu einer ListBox eine neue Zeile hinzufiigt (wie der Name schon andeutet). 
Sie konnen aber auch selbst eigene Methoden definieren. Eigenen Methoden gibt man einen Namen, der ihre Funktion 
beschreibt. Auch hier kann man einen Namen beliebiger Lange verwenden, der mit einem Buchstaben beginnen muss 
und ansonsten Zeichen von a-z, A-Z, 0-9, Umlaute und den Unterstrich (,,_“) enthalten darf. 

Im folgenden sehen Sie eine einfache Methode, die 1999 das Alter einer Person in Tagen berechnet, die 1960 geboren ist 
(nicht exakt, da Schaltjahre ignoriert werden): 


Dim yearBorn, thisYear, daysOld as Integer 

yearBorn=1960 

thisYear=1999 

daysOld=(thisYear-yearBorn)*365 

Methoden kénnen natiirlich erheblich komplexer als in diesem Beispiel sein. Es gibt drei verschiedene Stellen, an denen 
Sie ihren Programmcode unterbringen k6nnen. Dazu mehr im nachsten Kapitel. 


Kommentare und Dokumentation 


Es ist sehr wichtig, dass Sie Ihre Quelltexte gut dokumentieren, damit Sie auch nach ldngerer Zeit noch miihelos nach- 
vollziehen k6nnen, was Sie da programmiert haben. Sie sollten auSerdem die Steuerelemente und andere Objekte 
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logisch und konsequent benennen. Wenn jemand anders Anderungen an Ihrem Quelltext vornehmen muss, ist eine 
gute Dokumentation unverzichtbar. 


Kommentare kénnen in eigenen Zeilen stehen oder rechts an eine Code-Zeile anschlie&en. Die Kommentare sind nur 
Bestandteil des Quelltextes (also des Projekts), nicht der fertig gebauten Anwendung. 


Kommentare werden entweder mit einem einfachen Anfiihrungszeichen (‘), mit zwei Schragstrichen (//) oder mit dem 
Wort REM (ftir remark =Bemerkung) begonnen: 

//Anlegen der benédtigten Variablen 

Dim yearBorn, thisYear, daysOld as Integer 

yearBorn=1960 //Geburtsjahr merken 

thisYear=1999 //aktuelles Jahr merken 

//Das Alter in Tagen ausrechnen 

daysOld=(thisYear-yearBorn)*365 

Kommentare werden gemafs Vorgabe angezeigt. Sie konnen tiber die REALbasic-Voreinstellungen eine andere Farbe fiir 
die Kommentare auswahlen. 


Falls Sie mehrere aufeinanderfolgende Zeilen auskommentieren wollen (um den betreffenden Programmcode auszu- 
klammern), selektieren Sie mit der Maus die entsprechenden Zeilen und driicken dann 8-,“ (Mac) oder Strg-,,”* (Win- 
dows). Mit derselben Tastenkombination konnen Sie die Kommentare wieder in ausfiihrbaren Code zuriickverwandeln. 
Diese Technik ist vor allem dann niitzlich, wenn Sie voriibergehend mehrere Quelltextzeilen zu Testzwecken auskom- 
mentieren méchten. 


Eigenschaften dokumentieren 


Wenn Sie eine Eigenschaft fiir ein Fenster, ein Modul oder eine Klasse erzeugen, k6nnen Sie diese im Code-Editor doku- 
mentieren. REALbasic zeigt automatisch die Deklaration in Fettschrift an und bietet Ihnen die Méglichkeit, darunter 
eigenen Text einzuftigen. 


Der Text, den Sie an dieser Stelle eingeben, ist nicht ausfiihrbar. Selbst wenn es giiltiger REALbasic Code ist. 
Weitere Informationen finden Sie im Abschnitt Weitere Eigenschaften fiir ein Fenster anlegen“ auf Seite 205. 


e088 Fensterl Quellcode 
Vv @ Eigenschaften 
(ay Fenstertitel as String 


> yp Events Dies ist der Fenstertitel und ein Beispiel fir die 
v Konstanten Dokumentation einer Eigenschaft. 


Fenstertitel as String 


> [9 Menu-Handler 
> Bp Methoden 

> --} Notizen 

> tg Steuerelemente 


=] fe > 


Notizen eingeben 


Sie konnen Ihren Code (oder Ihre Anwendung) auch zentral mit Hilfe der Notiz-Option dokumentieren. Jeder Code-Edi- 
tor besitzt einen eigenes Notiz-Element, in dem Sie Notizen aufbewahren konnen. Genau wie Kommentare werden auch 
Notizen nicht compiliert und werden nicht in die fertige Anwendung tibernommen. Auch wenn die Notizen im 
Code-Editor auftauchen, sollten Sie nicht auf die Idee kommen, in Ihrem Code auf diese zu verweisen. 


Eine Notiz fligen Sie genauso wie ein Objekt ein. Rufen Sie Bearbeiten/Neue Notiz auf. Es erscheint eine Dialogbox 
(unter Mac OS X ein Sheet-Fenster), in der Sie die Notiz benennen k6nnen. 
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Abb. 137: Das Notiz-Sheet-Fenster unter Mac OS X und die Dialogbox unter Windows 


e808 Code Editor (AenderungenSichern) 

> P Eve 

b> My Mer Notiz-Name: 

> B met Neue Notiz 
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> Aa StaticTextl ’ 
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Jetzt erscheint die Notiz im Browser unter ,,Notizen“ und kann im Editor bearbeitet werden. 


e0c8e Code Editor (AenderungenSichern) 


> @ Events Verhalten unter Windows 

> (eq Menu-Handler Testen, wie dieses Fenster sich unter XP verhalt, 
> EB Methoden bevor die Windows-Version dieses Programms 
Notizen veréffentlicht wird 
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Werte an Methoden tibergeben 


Einige der in REALbasic eingebauten Methoden bendtigen zusatzliche Informationen, um ihre Aufgaben erfiillen zu kon- 
nen. Diese Informationen nennt man Parameter. Parameter werden an Methoden tibergeben, indem man sie rechts 
neben den Namen der Methode schreibt. Im folgenden Beispiel wird mit der Methode AddRow an die ListBox] eine 
Zeile angehangt. Dazu muss man noch einen Wert tibergeben, namlich den Inhalt der Zeile. In diesem Fall ist es der Text 
Januar’: 

ListBoxl.AddRow "Januar" 


Sie konnen den Parameter auch in Klammern setzen. Der folgende Ausdruck ist aquivalent: 

ListBoxl.AddRow ("Januar") 

Benotigt eine Methode mehr als einen Parameter, trennt man die Parameter mit Kommata voneinander. In der Klasse 
ListBox gibt es eine Methode InsertRow. Diese erlaubt es, neue Zeilen in eine bestehende ListBox einzuftigen. Dazu 


muss man InsertRow mitteilen, an welcher Stelle die neue Zeile eingefiigt werden soll und welcher Wert dann in dieser 
Zeile stehen soll: 


ListBoxl.InsertRow 3, "Januar" 

Auch mehrere Parameter k6nnen in Klammern gesetzt werden: 

ListBoxl.InsertRow (3, "Januar") 

Auch Variablen k6nnen als Parameter verwendet werden. Dabei wird der momentane Wert der Variablen an die Methode 
iibergeben: 


Dim Monat as String 
Monat="Januar" 
ListBoxl.InsertRow 3, Monat 


Arrays als Parameter tibergeben 


Ein eindimensionales Array kann als Parameter beim Aufruf einer Unterroutine oder Funktion tibergeben werden. Um 
festzulegen, dass es sich bei einem Parameter um ein Array handeln soll, versehen Sie ihn mit leeren Klammern: 


Names () as String 
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Obige Deklaration verwenden Sie, wenn Sie einer Unterroutine ein Array aus Strings tibergeben méchten. Da Sie die 
Anzahl der Elemente nicht angeben miissen, konnen Sie an verschiedenen Stellen im Code eine unterschiedliche Anzahl 
von Elementen tibergeben. 


Wenn Sie im Quelltext das Array als Parameter tibergeben, lassen Sie die Klammern weg, z.B.: 
PrintLabels (Names) 


PrintLabels ist der Name der Methode, die das String-Array als Parameter erwartet. 


Ruckgabe von Werten aus Methoden 


Manche Methoden liefern Ergebnisse zuriick. Das bedeutet, dass ein Wert von der Methode in der Zeile, in der sie aufge- 
rufen wurde, zuriickgegeben wird. Beispielsweise liefert die in REALbasic eingebaute Methode Ticks die Anzahl von 
Ticks (60stel Sekunden), die seit dem Einschalten des Rechners vergangen sind. Diesen Riickgabewert kdnnen Sie ganz 
normal z.B. einer Variablen zuweisen. Im Beispiel werden die Ticks der Variablen x zugewiesen: 

x=Ticks 

Einige Methoden bendtigen Parameter und geben einen Wert zurtick. Beispielsweise wird die Funktion Chr verwendet, 
um das ASCII-Zeichen mit einer bestimmten Nummer zuriickzugeben. Wird eine Methode aufgerufen, die einen Wert 
zurtickliefert, mtissen die Parameter in Klammern angegeben werden. Wird der Chr-Funktion eine 13 tibergeben — der 
ASCIl-Wert fiir Wagenriicklauf (Carriage-Return) — dann liefert sie das ASCII-Zeichen ftir Wagenrticklauf zurtick: 
x=Chr(13) 

Die Klammern sind erforderlich, weil der Riickgabewert auch direkt als Parameter fiir eine andere Methode eingesetzt 
werden kénnte. Im folgenden Beispiel kann man das sehen: 

ListBoxl.InsertRow 3, Str(Len("Hello")) 


In der ListBox1 wird eine Zeile an der dritten Position eingefiigt. In dieser Zeile soll die Lange der Zeichenkette “Hello”, 
also die Zahl 5 erscheinen. Die ListBox benotigt dazu eine Zeichenkette, die mit der Str-Funktion aus dem numerischen 
Ergebnis der Len-Funktion (die die Lange einer Zeichenkette liefert) erzeugt wird. 


Methoden, die ein Ergebnis zuriickliefern, bezeichnet man als Funktionen. In der Sprachreferenz sind solche Methoden 
als Funktionen markiert. 


Parameter als Wert oder als Referenz ibergeben 


Standardmafsig werden Parameter als Werte an Methoden tibergeben. Die Methode erhalt eine Kopie der Daten und 
kann Operationen mit diesen Daten ausftihren. 


Parameter, die als Werte iibergeben werden, werden innerhalb einer Methode als lokale Variablen behandelt — genauso 
wie Variablen, die mit dem Ausdruck Dim angelegt werden. Dies bedeutet, dass Sie die Werte der Parameter selbst ver- 
andern konnen, ohne vorher den Parameter einer lokalen Variable zuzuweisen. Wenn Sie zum Beispiel mit dem Parame- 


ter “x” einen Wert tibergeben, dann konnen Sie den Wert von x inkrementieren oder dekrementieren anstatt ihn einer 
okalen Variable zuzuweisen, die Sie zuerst mit einem Dim Ausdruck deklarieren miissten. 
Die folgende Methode besitzt also Giiltigkeit: 
Sub Square(a As Integer) 
a=a*a 

sgBox str(a) 
End Sub 
Wenn Sie Ihre eigenen Methoden programmieren, kGnnen Sie Informationen auch als Referenz tibergeben. In diesem 
Fall wird ein Zeiger auf das Objekt tibergeben, das die Informationen enthilt, es wird also keine Kopie der Daten ange- 
egt und Ihre Methode arbeitet mit den Originaldaten. Der Vorteil der Parametertibergabe als Referenz besteht darin, 
dass die Methode die Werte jedes Parameters verandern kann und diese dann auch in der aufrufenden Methode verin- 
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dert sind. Das ist nicht méglich ist, wenn die Parameter als Werte tibergeben werden, da sie dann ja nur Kopien der Ori- 
ginaldaten sind. 


Parameter als Referenz zu tibergeben ist vor allem dann von Nutzen, wenn Ihre Methode mehrere Werte zuriickliefern 
muss. Wenn die Parameter als Werte tibergeben werden, kann die Methode nur einen einzigen Wert zuriickliefern 
(indem Sie die Methode als function deklarieren und der Wert als Ergebnis der Funktion zuriickgegeben wird). 

Mit den Schliisselw6rtern ByVal und ByRef kGnnen Sie festlegen, welche Art der Parametertibergabe verwendet werden 
soll. Stillschweigend wird von ByVal ausgegangen, Sie miissen es also nicht extra deklarieren. Um einen Parameter als 
Referenz zu tibergeben, mtissen Sie in der Methodendeklaration das Schliisselwort ByRef verwenden. Das Beispiel in 
Abbildung 138 zeigt, wie ein Parameter als ByRef deklariert wird. 


Abb. 138: Parameterdeklaration ByRef 


Neue Methode 


Methode: Quadriere 

Parameter: ByRef d As Double Methode: Quadrieren 
Parameter: ByRef d As Double 

Riickgabetyp: (D) 

() Private Riickgabetyp: 


Cou) ED aia 


Abbrechen, 


Falls der Code, der die Methode aufruft, so aussieht: 


dim a as integer 

a=3 

quadriere a 
editFieldl.text=str(a) 


und die Methode selbst so aussieht: 

a=a*a 

wird in editField1 die Zahl 9 erscheinen. Wenn Sie nicht explizit ByRef angeben, kann die Methode den an sie iibergebe- 
nen Wert verandern, aber den geanderten Wert nicht ausgeben. 


Sie konnen auch Arrays als Referenz tibergeben. Dazu geben Sie das Array ohne das Schliisselwort ByRef an. Arrays wer- 
den grundsiatzlich als Referenz tibergeben. Wenn Sie ein String-Array tibergeben wollen, das Namen enthilt, wiirden Sie: 
aNames () as String 


in den Parameter-Abschnitt im Methoden-Dialog eingeben. Wenn Sie ein Array tibergeben, kann die Methode alle Ele- 
mente des Arrays andern. 


Vergleichsoperatoren 


Es kommt oft vor, dass man zwei Werte vergleichen muss, um herauszufinden, ob eine bestimmte Bedingung erfiillt ist. 
Tatsachlich stellt man dabei eine Behauptung auf, die entweder wahr oder falsch ist. Die Behauptung ,Mein Hund ist 
eine Katze“ ist normalerweise falsch. Dagegen kann Mein Hund wiegt mehr als meine Katze“ wahr oder falsch sein. Sol- 
che Vergleiche wertet man mit den folgenden Operatoren aus: 


Beschreibung Symbol Numerisches Beispiel Ergebnis 
Gleichheit - 5=5 True 


Ungleichheit <> 5<>5 False 
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Beschreibung Symbol Numerisches Beispiel Ergebnis 
GroBer als > 6>5 True 
Kleiner als < 6<5 False 
GroBer oder gleich >= 6>=5 True 
Kleiner oder gleich <= 6<=5 False 


Auch Strings und boole’sche Werte knnen fiir Vergleiche herhalten. String-Vergleiche sind unabhangig von der Grof-/ 
Kleinschreibung (case insensitive) und alphabetisch geordnet. Die Strings ,,Jannice“ und ,jannice“ sind gleich, aber ,,Jan- 
nice“ ist kleiner als ,,Jason“, da ,,Jannice“ im alphabetischen Sinn vor ,,Jason“ kommt. Sollten Sie einen Vergleich benoti- 
gen, der die Grof’-/Kleinschreibung beriicksichtigt oder lexikographisch ist, dann verwenden Sie die StrComp-Funktion. 
Siehe StrComp in der Sprachreferenz. 


Mehrere Vergleiche zugleich 


Es ist méglich, mehrere Vergleiche zugleich auszuftihren, indem man die Operatoren ,,or“ und and“ verwendet. 


And (und) Operator 

Verwenden Sie diesen Operator, wenn alle beteiligten Vergleiche ,;Irue* ergeben sollen. Wenn im folgenden Beispiel die 
Variable x den Wert 5 annimmt, so resultiert fiir den Gesamtausdruck der Wert ,,False‘: 

x>1 And x<5 


Or (oder) Operator 
Ist es ausreichend, dass einer der Komponenten im Vergleich ,True“ ergibt, dann wird der Operator ,,or“ eingesetzt. Ist x 
im Beispiel wieder 5, dann ergibt der Vergleich diesmal ,,True*: 


x>l Or x<5 


Not (nicht) Operator 
Verwenden Sie den Not Operator, um den Wert eines boole’schen Ausdruck umzukehren. Zum Beispiel priift 


Not (x < 0) 
ob x gro8er oder gleich Null ist. Oder anders ausgedriickt, ob x nicht kleiner Null ist. 
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Manchmal muss eine Reihe von Anweisungen mehrfach ausgeftihrt werden. Soll beispielsweise nach dem Driicken eines 
Knopfes dreimal ein Signalton zu horen sein, konnten Sie nattirlich einfach dreimal nacheinander das Beep-Kommando 
aufrufen: 

Beep 

Beep 

Beep 

Sollen Anweisungen aber fiinfzigmal ausgefiihrt werden, oder ist die Anzahl der Ausftihrungen abhangig von weiteren 
Bedingungen, so ist dies auf diese Weise entweder sehr ineffizient oder gar nicht méglich. Daher bedienen Sie sich einer 
Schleife, um diese Anweisungen mehrfach ausftihren zu lassen. Davon gibt es verschiedene Arten. 


While...Wend 


Eine While-Schleife fiihrt die Anweisungen zwischen While und Wend (While End) aus, solange die Bedingung, die bei 
While angegeben wird, erfiillt ist (,True*): 
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Dim n As Integer 


While n<10 
n=n+1 
Beep 
Wend 


Die Variable n hat nach dem Anlegen durch Dim den Wert 0. Da 0 kleiner als 10 ist, beginnt die Schleife mit der Ausftih- 
rung. Ware im Beispiel n bereits 10, dann wiirde die Schleife nichts tun und die Programmausftihrung wiirde hinter 
Wend fortgesetzt. Die Anweisungen in der Schleife werden nun immer wieder ausgeftihrt. Die Variable n wird um eins 
erhdht und dann wird per Beep ein Signalton ausgegeben. Beim Erreichen von Wend tiberpriift REALbasic die Bedin- 
gung, die bei While steht. Ist diese ,True“, dann wird das Programm mit der ersten Zeile nach dem While fortgesetzt. In 
unserem Beispiel wird dann also n wieder um eins erhdht. Hat n den Wert 10 erreicht, dann wird das Programm hinter 
dem Wend fortgesetzt — die Schleifenausftihrung ist beendet. 


Do...Loop 


Do-Loop-Schleifen verhalten sich ahnlich wie While-Schleifen. Im Unterschied zu diesen werden Do-Loop-Schleifen 
solange ausgeftihrt, bis eine Bedingung ,True“ ist, wahrend While-Schleifen solange ausgefiihrt werden, solange eine 
Bedingung , True“ bleibt. Do-Loop-Schleifen sind flexibler, da man die Bedingung am Anfang oder am Ende der Schleife 
priifen kann: 

Do Until n=10 

n=n+1 

Beep 

Loop 

oder 

Do 

n=n+1 

Beep 

Loop Until n=10 


Der Unterschied liegt darin, dass die erste Schleife nicht ausgefiihrt wird, wenn n schon den Wert 10 hat, wahrend die 
zweite Schleife unabhangig vom Wert von n mindestens einmal ausgefiihrt wird, da erst am Ende abgefragt wird, wel- 
chen Wert n hat. 
Es ist méglich, eine Do-Loop-Schleife zu programmieren, die keine Bedingungen abfragt: 
Do 

n=n+1 

Beep 
Loop 
Weil hier keine Endbedingung vorliegt, wird die Schleife endlos ausgefiihrt. Mit der Exit-Methode I4sst sich die Ausftih- 
rung einer solchen Schleife beenden. Allerdings ist dies sehr schlechter Programmierstil, denn man muss erstmal die 
gesamte Schleife durchforsten, bis man herausfindet, wodurch sie beendet wird. 


Endlosschleifen 


Sie miissen immer sicherstellen, dass die Endbedingungen Ihrer Schleifen auch irgendwann eintreffen. Ist dies nicht der 
Fall, dann bleibt das Programm an dieser Stelle hangen. In der Praxis wird Ihnen das wahrend der Entwicklung passieren. 
Ein Programm, das in einer Schleife steckenbleibt, ldsst sich mit 38-Shift-,,.“ abbrechen. Mit $8-K (Windows: Strg-K oder 
Strg+Alt+ Entfernen) lasst sich das Programm, das in der Schleife steckt, dann beenden. 
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Lange Schleifen 


Wenn eine Schleife begonnen wird, tibernimmt ihr Prozess die Kontrolle und erlaubt es dem Anwender nicht, Inter- 
face-Elemente wie Meniis, Knopfe und Scrollbalken zu bedienen. Auf schnellen Rechnern und kleinen Schleifen ist das 
kein grofseres Problem, da die Schleife meist schneller abgearbeitet ist als der Anwender die nachste Aktion unterneh- 
men will. Wenn das jedoch nicht der Fall ist, konnen Sie folgendes machen: 


e@ Wenn der Anwender warten soll, bis die Schleife beendet ist, bevor er etwas anderes machen darf (z.B., weil eine 
Aktion des Anwenders das Ergebnis der Schleife ungiiltig machen kdnnte), k6nnen Sie anzeigen, dass eine langere 
Operation im Gange ist, indem Sie den Mauszeiger in die Armbanduhr verwandeln, bis die Schleife beendet ist. 
Bedenken Sie dabei, dass der Anwender in diesem Fall die Schleife nicht vorzeitig abbrechen kann. Mehr Informatio- 
nen finden Sie im Abschnitt tiber MouseCursor in der Sprachreferenz. 

e Wenn es dem Anwender erlaubt sein soll, andere Dinge zu tun, wahrend die Schleife lauft, sollten Sie den Code der 
Schleife in einen separaten Thread platzieren. Ein Thread lduft als Hintergrund-Task und erlaubt dem Anwender im 
Vordergrund weiterzuarbeiten. 

Vermeiden Sie lang andauernde Operationen innerhalb von Schleifen. Versuchen Sie, diese einmalig auferhalb vorzu- 

nehmen und dann darauf aus der Schleife heraus zu verweisen. Wenn sich dies nicht vermeiden lasst, konnen Sie die 

Methode DoEvents der Application Klasse verwenden, um Prozessorzeit an REALbasic zurtickzugeben, damit ausste- 

hende Events abgearbeitet werden kGnnen. Dies betrifft zum Beispiel Tastatur- oder Mauseingaben. Naheres finden Sie 

in Eintrag tiber die Application Klasse in der Sprachreferenz. 


For...Next 


While- und Do-Loop-Schleifen sind perfekt geeignet, wenn die Anzahl der Ausfiihrungen von komplexen Bedingungen 
abhidnet. Kann die Anzahl der Schleifendurchgdnge numerisch bestimmt werden, dann verwendet man gewohnlich eine 
For-Next-Schleife. Sollen zum Beispiel in einer ListBox die Zahlen eins bis zehn eingetragen werden, dann bietet sich die 
Verwendung einer For-Next-Schleife an, da die Anzahl der Ausfiihrungen bereits feststeht. Eine solche Schleife ist wie 
folgt aufgebaut: 


Dim zadhler, Startwert, Endwert As Integer 


For zahler=Startwert to Endwert 
Leigener Programmcode] 
ext 


Im Beispiel ist der Zahler der For-Next-Schleife als Integer deklariert. Dies ist zwar tiblich, aber nicht zwingend erforder- 
ich. Sie konnen die Zahler-Variable auch als Single oder Double deklarieren. Bei Beginn der Schleifenausfiihrung wird 
die Zahlvariable auf den Startwert gesetzt und beim Erreichen von Next automatisch um eins erhdht. Hat sie den End- 
wert erreicht, wird die Schleife noch einmal ausgeftihrt. Erst wenn der Zahler grofer ist als der Endwert, endet die 
Schleifenausfiihrung. Unser Beispiel sieht so aus: 


Dim i As Integer 


For i=1 to 10 
ListBoxl.AddRow Str(i) 
Next 


In der Schleife wird jeweils die Zahl i in eine Zeichenkette gewandelt und an die ListBox tibergeben. Dies geschieht 
genau zehnmal. 

Anmerkung: Der Buchstabe ,i* wird sehr haufig als Zahler fiir Schleifen verwendet. Dies geht auf die Programmierung in 
FORTRAN zuriick, denn in FORTRAN sind die Buchstaben von I bis N automatisch als Integer-Variablen deklariert. Daher 
wurden diese Buchstaben normalerweise fiir Zahler verwendet. Sind Schleifen ineinander verschachtelt, dann werden 
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die nachsten Buchstaben verwendet, also J, K und so weiter. Wenn man sich daran halt, dann macht man es anderen Pro- 
grammierern leichter, den Code zu durchschauen. 


Normalerweise werden die Schleifenzahler um eins erhoht. Dies lasst sich mit dem Befehl Step dndern. Im Beispiel wird 
der Zahler immer um ftinf erhoht: 


Dim i As Integer 

For i=5 to 100 Step 5 
ListBoxl.AddRow Str(i) 
ext 


Im nachsten Beispiel beginnt der Zahler bei 100 und wird jeweils um ftinf erniedrigt: 


Dim i As Integer 

For i=100 Downto 1 Step 5 
ListBoxl.AddRow Str(i) 
ext 


Bisher haben wir Falle behandelt, in denen Startwert und Endwert Integer-Zahlen waren. Wenn entweder Startwert oder 
Endwert Ausdriicke sind, die berechnet werden miissen, fiihrt die For-Schleife diese Berechnung jedesmal durch, wenn 
der Zahler erhdht wird — auch wenn die Berechnung jedesmal zum gleichen Ergebnis fiihrt. 

Daher ist es ratsam, die Berechnungen durchzuftihren, bevor die Schleife beginnt. Wenn Sie z.B. eine Schleife bensti- 
gen, die alle installierten Fonts bearbeitet, konnen Sie im Voraus nicht wissen, wieviele das sind. Mit der Funktion Font- 
Count kénnen Sie die Anzahl der Fonts ermitteln. Wenn Sie die Schleife folgendermafen verwenden: 

For i=0 to FontCount-1 


ext 


wird die Schleife sehr viel langsamer ablaufen, als wenn Sie den Wert nur einmal ermitteln: 


Dim nFonts as integer 
nFonts=FontCount-1 
For i=0 to nFonts 


ext 


Der Geschwindigkeitsunterschied ist meist nicht zu bemerken, bis es sich um eine sehr lange Schleife handelt. Auf dem 
Rechner, auf dem dieses Handbuch geschrieben wurde und auf dem 120 Fonts installiert sind, ist der Unterschied zwi- 
schen beiden Varianten gerade einmal 1/250 Sekunde. 


Schleifen lassen sich ineinander schachteln. Man muss nur darauf achten, dass die Zahlvariablen unterschiedlich sind 
und sich nicht gegenseitig verandern. Im folgenden Beispiel soll gezahlt werden, in wievielen Zellen einer mehrspaltigen 
ListBox das Wort ,,hello* steht: 

Dim row, column, count As Integer 

For row=0 to listBoxl.ListCount-1 

For column=0 to 1istBox1.ColumnCount-1 

if listboxl.cell(row,column)="hello" then 

count=count+1 

End if 

Next 
Next 
MsgBox Str(count) 


Eine andere Vorgehensweise ist die Verwendung von Namen, wie sie von FORTRAN-Programmierern zuerst benutzt 


wurde. Hierbei verwendet man die Buchstaben des Alphabets, beginnend mit i als Zahler. Auf diese Weise sieht man 
sofort, welche Schleife sich in welcher befindet, ohne dass Sie tiberlegen miissen, was die Schleifen machen. 
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For-Next-Schleifen sind anderen Schleifen vorzuziehen, weil der daraus resultierende Maschinencode effizienter ist, da 
sich solche Schleifen besser compilieren lassen. 


For...Each 


For...Each durchlauft die Schleife nicht fiir jeden Wert eines Zahlers, sondern fiir jedes Element eines Arrays: 


Function SumStuff(values() as Double) as Double 

Dim sum, element as Double 

For Each element In values 

sum=sum+element 

Next 

Return Sum 

,values* ist ein eindimensionales Array mit Zahlen, das an die Funktion ,SumStuff“ tibergeben wird. Im For..Each-Aus- 
druck tibernimmt die Variable element‘, die auf ein Element im Array verweist, die Rolle der Zahlervariable. Die 
For...Each-Schleife fiihrt ftir jedes Element im Array die Anweisungen zwischen dem For..Each-Ausdruck und dem 
Next-Ausdruck aus. 


Da das Array nicht unbedingt aus Zahlen bestehen muss, konnen Sie mit diesem Ausdruck Objekte beliebigen Typs ver- 
arbeiten. Dabei kdnnte es sich um Bilder, Farben, Dokumente, Datensatze usw. handeln. 


Um die Funktion aus dem Beispiel aufzurufen, tibergeben Sie ihr als Parameter ein Array aus Double-Werten: 
s=SumStuf f (MyNumbers ) 


Die Variable s wurde dabei als Double deklariert. 


Verzweigen 


Der Programmcode in Ihren Methoden wird von oben nach unten Zeile ftir Zeile ausgeftihrt. Oft ist es aber erforderlich, 
dass abhdngig von bestimmten Bedingungen nur Teile des Codes einer Methode ausgefiihrt werden sollen. Dazu ver- 
zweigt man entweder tiber If...Then...End If oder Select. . .Case. 


If... Then...End If 


Mit If... Then tiberprtift man eine logische Bedingung und fiihrt den darin eingeschlossenen Code abhangig vom Ergeb- 
nis aus oder tiberspringt ihn. Eine solche Anweisung sieht so aus: 


i 


f Bedingung Then 
Leigener Programmcode] 
End If 


Angenommen, Sie haben eine Integer-Variable namens Monat und méchten nur dann etwas bestimmtes ausftihren, 
wenn diese den Wert 1 hat, dann tun Sie dies: 
If Monat=1 Then 


Leigener Programmcode] 
End If 


Monat=1 ist ein boole’scher Ausdruck, der entweder True oder False annimmt, je nachdem ob Monat den Wert 1 hat 
oder nicht. 


Nehmen wir mal an, dass Sie eine Checkbox verwenden, die dariiber bestimmen soll, ob ein bestimmter Programmteil 
ausgefiihrt wird. Sie tiberpriifen dann den boole’schen Wert der Checkbox ganz einfach so: 
If checkboxl.value Then 


Leigener Programmcode] 
End If 
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If... Then...Else...End If 


Es kommt auch vor, dass man zwei unterschiedliche Dinge tun mochte. Die eine Aktion soll stattfinden, wenn eine 
Bedingung erfiillt ist und ist das nicht der Fall, dann soll etwas anderes geschehen. Man unterteilt den Code dann in zwei 
Teile. Diese werden von Else getrennt: 

If month=1 Then 

MsgBox "Es ist Januar." 

Else 


MsgBox "Es ist nicht Januar." 
End If 


If...Then...Elself...End If 


Soll im Else-Teil noch eine weitere Bedingung gepriift werden, kann man daftir Elself verwenden: 


If month=1 Then 

MsgBox "Es ist Januar." 

Elself month<4 Then 

MsgBox "Es ist zwar nicht Januar, aber immer noch Winter." 
End If 


Dies hatte man natiirlich auch bewirken k6nnen, indem man einen weiteren If... Then-Teil innerhalb des Else-Teils ein- 
gebaut hatte. Das wiirde aber ein weiteres End If ins Spiel bringen und das Programm ware schwerer zu lesen. Der 
wahre Beitrag von Elself zur Ubersichtlichkeit des Programms wird klar, wenn man sich folgendes Beispiel ansieht, das 
zeigt, dass mehrere Elself-Abfragen hintereinander stehen diirfen: 

f month=1 Then 

sgBox "Es ist Januar." 

ElseIf month<4 Then 

sgBox "Es ist noch Winter." 

ElseIf month<6 Then 

sgBox "Jetzt ist es Frithling." 

End If 


WH 


Ist die If-Bedingung False, dann testet REALbasic der Reihe nach alle Elself-Bedingungen. Sobald eine davon True ergibt, 
wird der dazugeh6rende Code ausgefiihrt und das Programm nach EndIf fortgesetzt. Beachten Sie, dass weitere 
Elself-Teile danach nicht mehr zur Ausftihrung kommen. 


Select...Case 


Wenn Sie mehrere mégliche Werte einer Variablen oder einer Eigenschaft zur Verzweigung verwenden méchten, dann 
bietet sich die Verwendung von Select. ..Case an: 


f Tag=2 Then 

sgBox "Montag." 
self Tag=3 Then 
sgBox "Dienstag." 
self Tag=4 Then 
sgBox "Mittwoch." 
self Tag=5 Then 
sgBox "Donnerstag. 
self Tag=6 Then 
sgBox "Freitag." 
Else 

sgBox "Wochenende. 
End If 


4 


al 


m 


m 


m 
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Diese Bedingungen schliefen sich alle gegenseitig aus. Es ist also immer nur jeweils eine erfiillt. In einem Select... .Case 
ist das allerdings erheblich tibersichtlicher: 


Select Case Tag 


Case 2 

sgBox "Montag." 
Case 3 

sgBox "Dienstag." 
Case 4 

sgBox "Mittwoch." 
Case 5 

sgBox "Donnerstag." 
Case 6 

sgBox "Freitag." 
Else 

sgBox "Wochenende." 
End Select 


Die Select... .Case-Anweisung vergleicht die hinter Select Case angegebene Variable oder Eigenschaft nacheinander mit 
den in den Case-Zweigen aufgeftihrten Werten. Trifft ein Wert zu, wird der Code des betreffenden Case-Zweiges bis zum 
nachsten Case ausgeftihrt. Treffen mehrere Case-Zweige zu, wird trotzdem nur der erste zutreffende Zweig ausgeftihrt. 
Zu einer Select... .Case-Anweisung kann ein abschliefSender Else-Zweig gehoren, der fiir alle nicht explizit angegebenen 
Case-Werte ausgeftihrt wird. 


Die Select. ..Case-Anweisung funktioniert mit Variablen beliebigen Typs, wie z.B. String, Integer, Single, Double, Boolean 
und Color. Zum Beispiel knnen Sie Farben vergleichen: 


Dim c as Color 

c=&cFFOO00 //Rot 

Select case c 

case &cOOFFOO // Grtin 
MsgBox "Grtin" 

case &cFFOO00 // Rot 
MsgBox "Rot" 

case &cOQOOOFF // Blau 
MsgBox "Blau" 

End select 


Ein Case-Ausdruck akzeptiert auch mehrere Werte, die durch Komma getrennt sind. Ein Beispiel: 


Dim c as color 

c=&cFFOO00 //Rot 

Select case c 

case &cOOFFOO,&cFFO000 //Griin, Rot 
sgBox "Grtin oder Rot" 

case &cFFOO00 //Rot 

sgBox "Rot" 

case &cOOO0FF //Blau 

sgBox "Blau" 

End select 


Im letzten Beispiel ist der erste Case-Ausdruck wahr, da c den Wert &cFF0000 hat. Obwohl der zweite Case-Ausdruck 
ebenfalls wahr ware, wird dieser nicht ausgeftihrt, da er nicht der erste zutreffende Ausdruck war. 


Ein Case-Ausdruck akzeptiert sogar einen Wertebereich, den Sie mit dem ,,Io“ Schliisselwort angeben. Zum Beispiel: 
Dim i as Integer = 53 
Select case i 
Case 1 to 25 
msgBox "25 or less" 
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Case 26 to 50 
MsgBox "26 to 50" 
Case 51 to 100 
MsgBox "51 to 100" 
End Select 


Im Beispiel ware der dritte Case-Ausdruck wahr. 
Sie konnen auch Wertebereiche mit einzelnen Werten kombinieren: 
Case 0, 26 to 50, 75, 100 to 200 


Sie kénnen auch auf Ungleichheit priifen, indem Sie das ,,Is“-Schliisselwort und einen Vergleichsoperator verwenden 
(z.B.<,>,<=,>=). Zum Beispiel: 


Dim 7 as Integer = 10 
Select Case i 

Case Is <= 10 

//this case selected 
Case Is > 10 

//this case not selected 
End Select 


Auch Vergleichsoperatoren lassen sich mit einfachen Werten kombinieren: 


Dim i as Integer = 75 
Select Case i 

Case 0, Is <=10,100 
//case not selected 
Case Is > 10, Is < 99 
//case selected 

End Select 


Sogar Funktionen lassen sich verwenden, wenn sie den erforderlichen Datentyp zurtickgeben: 


Dim 7 as Integer = 4 
Dim a as Integer = 2 
Select Case i 
Case Functx(a) 
//case 
Case a 
//case 2 
Else 
//no match 
End Select 


Die Funktion im ersten Case-Ausdruck sahe so aus: 


Function Functx(a As Integer) as Integer 
Return a*a 
End Function 


Die Funktion quadriert den angegeben Wert, so dass der erste Case-Ausdruck zutrifft. 

Im Falle einer derart einfachen Funktion konnen Sie die Berechnung auch direkt in den Case-Ausdruck schreiben. Damit 
wiirde dieser so aussehen: 

Case axa 

Die Select...Case-Anweisung kann sogar Variablen vom Typ Objekt vergleichen. Im folgenden Beispiel wird 
Select...Case verwendet, um den Button zu ermitteln, den der Benutzer in einem MessageDialog gedriickt hat. Dabei 
werden Objekte vom Typ MessageDialogButton verglichen, um zu ermitteln, welcher der drei Buttons gedrtickt wurde. 


Dim d as New MessageDialog //MessageDialog-Objekt deklarieren 
Dim b as MessageDialogButton //Das zu priifende Ergebnis nach dem Klick 
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Co. oh, eo 


d. 


b 
S 


E: 


.icon=1 //Zeige ein ‘Warnung’-Icons 
-ActionButton.Caption="Sichern" 

.CancelButton.Visible=True //Abbrechen-Button anzeigen 
.AlternateActionButton.Visible=True //Alternativ-Button anzeigen 
-AlternateActionCaption='Nicht sichern" 

.Message="Anderungen vor Beenden sichern?" 

Explanation="Die Anderungen gehen verloren, wenn Sie sie nicht sichern." 
=d.ShowModal //Zeige Dialog modal an 

elect Case b //Der MessageDialogButton der d zugewiesen wurde 
Case d.ActionButton //ermittle welcher Button gedriickt wurde 
//Benutzer hat sichern geklickt 

Case d.AlternateActionButton 

//Benutzer hat nicht sichern geklickt 

Case d.CancelButton 

//Benutzer hat abbrechen geklickt 

nd Select 
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cites Programmieren mit Events und 
Objekten 


Die meisten Teile Ihres Programms werden auf Eingaben des Benutzers reagieren. Der Benutzer lost dabei Events, also 
Ereignisse aus, auf die Ihr Programm reagieren muss. Sie miissen verstehen, wie Events funktionieren, wann sie auftre- 
ten und wie man sie zur Programmsteuerung verwendet, damit das Programm letzten Endes das tut, was Sie méchten. 


In diesem Kapitel werden Sie einiges tiber Event-gesteuerte Programmierung lernen, wie man den Code-Editor verwen- 
det und wie man dafiir sorgt, dass ein Programm auf Eingaben des Benutzers reagiert. 


Inhalt 


e Event-gesteuertes Programmieren 

© Benutzung des Code Editors 

© Drucken und Export/Import von Programmcode 
© Programmierung von Event-Handlern 


Eventgesteuertes Programmieren 


Die Benutzer Ihres Programms werden mit dem Programm kommunizieren, indem sie mit der Maus klicken oder etwas 
auf der Tastatur eingeben. Jedesmal, wenn ein Benutzer mit der Maus auf das Benutzer-Interface Ihres Programmes 
klickt oder beispielsweise mit der Tastatur etwas in ein EditField eingibt, wird ein Event ausgelést. Events sagen Ihrer 
Anwendung ganz einfach, was der Benutzer getan hat und wo dies passiert ist. Es kann auch sein, dass ein Event indirekt 
andere Events auslést. Klickt der Benutzer auf einen Mentipunkt, dann ist dies ein Event. Offnet sich daraufhin ein Fens- 
ter, dann wird durch das Event ,,Mentipunkt ausfiihren‘ indirekt ein zweites Event, namlich das Offnen des Fensters, aus- 
gelost. 


Jedes REALbasic-Objekt kann den zur Behandlung der empfangenen Events bendtigten Code enthalten. 


Ein PushButton kann beispielsweise den Code enthalten, der ausgefiihrt werden soll, wenn das Event eintritt, das der 
Benutzer auf ihn klickt. Ein Objekt kann sogar auf Events reagieren, an die Sie vielleicht noch gar nicht gedacht haben. 
Zum Beispiel kann ein Event auftreten, wenn der Benutzer einfach nur die Maus tiber das Objekt bewegt. Wenn der 
Benutzer ein Event ausldst, dann priift REALbasic, ob bei dem betreffenden Objekt Code zur Behandlung dieses Events 
vorgesehen ist. Sollte das der Fall sein, wird der entsprechende Code ausgeftihrt und danach wartet REALbasic auf das 
nachste Event. Dies wird fortgesetzt, bis schlielich ein Event eintritt, das die Programmausftihrung beendet (normaler- 
weise wenn der Benutzer Beenden im Ablage-Menii auswahlt). 


PushButtons haben unter anderem ein Event, das Action heift und ausgelést wird, wenn der Benutzer auf den Knopf 
klickt. Den Programmcode, der ausgefiihrt wird, wenn das Event ausgelost wird, nennt man Event-Handler, eben weil 
hier der Code abgearbeitet wird, der zu dem ausgelésten Event gehort. Soll der Knopf zum Offnen eines Fensters die- 
nen, dann lost er indirekt wieder ein weiteres Event aus, namlich das Open-Event des neuen Fensters, das immer auto- 
matisch beim Offnen eines Fensters ausgelést wird. 


Es gibt eine ganze Menge von Events, die jedes Objekt, das Sie verwenden, empfangen kann. Gliicklicherweise mtissen 
Sie nicht alle Events selbst behandeln. 
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Benutzung des Code-Editors 


Der Code-Editor dient zur Eingabe des Programmcodes der einzelnen Events, die ftir die verwendeten Objekte hres 
Benutzer-Interface auftreten konnen. Hier werden auSerdem neue Methoden und Eigenschaften angelegt. Der 
Code-Editor besteht aus dem eigentlichen Editor und einem Browser-Fenster. 


Abb. 139: Der Code Editor 


Objektliste (Browser) Editor 
eee | Code Editor (TextFenster) : 
> > GropsseMenue —_ 


Sub Paint{g As Graphics) 
g.ForeColor=rgb(0,0,0) // schwarz 
se g.DrawRect(0,0,g.Width-1 ,g.Height- 1) 
*\ DropObject g.ForeGolor=TextFeld.SelTextColor 
“| GotFocus g.FillRett(1, 1,g.Width-2,g.Height-2) 
“S KeyDown End Sub 


Disclosure Triangle ——————__®w__ [J KnopfFarbe 


»\ LostFocus 
*/ MouseDown 
“ MouseDrag | 
*\ MouseEnter 
“| MouseExit 
“| MouseMove 
‘\ MouseUp 
Open 
= Paint a 
> >| KnopfFett ’ 


Fenster 6ffnen ————————@] [=| 


Leere Methoden ein/ausblenden 


Riickwarts_ Vorwarts 


Der Browser zeigt eine hierarchische Liste der Komponenten, aus denen ein bestimmtes Fenster besteht. Er zeigt fol- 
gende Elemente, die fiir das Fenster verwendet wurden: 

Steuerelemente (Controls) 

Events 

Menii-Handler (Menu Handlers) 

Methoden (Methods) 

Eigenschaften (Properties) 

Notizen 


Offnen des Code-Editors 


Der Code-Editor wird dazu verwendet, um Code von Steuerelementen, Fenstern, Klassen und Modulen zu editieren. Sie 
k6nnen den Code-Editor auf verschiedene Arten 6ffnen. 


Um den Code-Editor fiir ein Fenster aus dem Projektfenster zu 6ffnen, unternehmen Sie folgendes: 


1. Rufen Sie das Kontextmenii des Fensters auf, indem Sie die Ctrl-Taste gedriickt halten und gleichzeitig auf den 
Namen des Fensters klicken. Unter Windows klicken Sie mit der rechten Maustaste auf den Namen des Fensters im 
Projektfenster. 


2. Wahlen Sie Code bearbeiten aus dem Kontextmenii. 


Um den Code-Editor fiir ein Fenster oder ein Steuerelement von einem Fenstereditor aus auszurufen, unternehmen Sie 
folgendes: 


Klicken Sie auf das Fenster im Projektfenster und driicken Sie Strg+-Enter oder Alt+Tab (Macintosh) oder fiihren Sie 
einen Ctrl-Klick (Windows: Rechtsklick) auf dem Fenster aus, um das Kontextmenti des Fensters anzuzeigen. Wahlen Sie 
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dann aus dem Code bearbeiten-Menii den Event, den Sie 6ffnen méchten. Wenn Sie einen Doppelklick auf einem 
Fenster ausftihren, 6ffnet sich im Code-Editor der Open-Event-Handler des Fensters. Mit dem Kontextmenti konnen Sie 
auswahlen, welchen Event-Handler Sie 6ffnen méchten. Das Code bearbeiten-Untermenii enthilt eine komplette Liste 
der Events ftir das Fenster. 


Abb. 140: Das ,,Code bearbeiten”-Untermenii eines Fensters 


Wahle > 
Alles auswahlen 


Code bearbeiten (Window1) > Open 


Steuerelement hinzufiigen > Close 
CancelClose 
KeyDown 
MouseMove 
MouseEnter 


Paint 
MouseDown 
MouseDrag 
MouseUp 
EnableMenultems 
Resized 
Resizing 
Moved 
DropObject 
Activate 
Deactivate 


Um fiir ein Steuerelement den Default-Event im Code-Editor zu 6ffnen, gehen Sie folgendermafsen vor: 
1. Falls es nicht schon offen ist, 6ffnen Sie das Fenster, welches das Steuerelement enthilt. 


2. Fiihren Sie auf dem Steuerelement einen Doppelklick aus oder wahlen Sie das Steuerelement aus und driicken Sie 
die Return-Taste. 


Dies 6ffnet den Code-Editor fiir das Elternfenster des Steuerelements. Der Browser des Code-Editors expandiert dann 
automatisch die Kategorie ,,Steuerelemente’, in dieser das Steuerelement, das Sie angeklickt haben und selektiert den 
Default-Eventhandler (z.B. bei einem PushButton den Action-Eventhandler). 


Jedes Steuerelement besitzt seinen eigenen Default-Eventhandler. Der Default-Event eines PushButtons ist beispiels- 
weise der Action-Event, der eines Scrollbars der ValueChanged-Event und der einer ListBox der Change-Event. 


Wenn Sie einen Doppelklick auf ein Steuerelement ausfiihren, 6ffnet sich der Code-Editor und zeigt den 
Default-Event-Handler fiir dieses Steuerelement. 


Um fiir ein bestimmtes Steuerelement gezielt einen Event im Code-Editor zu 6ffnen, gehen Sie folgendermafen vor: 


1. Fihren Sie einen Ctrl-Klick (Windows: Rechtsklick) auf ein Steuerelement im Fenster aus, um das Kontextmenii ftir 
dieses Steuerelement anzuzeigen. 


2. Wahlen Sie aus dem Code bearbeiten-Untermenii den Event-Handler aus, den Sie bearbeiten wollen. 


Der Code bearbeiten-Meniicintrag fiir ein individuelles Steuerelement zeigt die Events fiir dieses Steuerelement an. 
Verwenden Sie es dazu, um einen bestimmten Event-Handler direkt anzusteuern. 
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Abb. 141: Das ,,Code bearbeiten”-Untermenii eines ListBox-Steuerelements 


Change 
DoubleClick 
KeyDown 
EnableMenultems 
ExpandRow 
CollapseRow 
DragRow 
Ausschneiden SortColumn 
Kopieren CellAction 
GotFocus 
Léschen 
CellBackgroundPaint 
CellTextPaint 
CellClick 
CellkeyDown 
Steuerelement hinzufiigen > CellTextChange 
CellGotFocus 
CellLostFocus 
MouseDown 
MouseDrag 
MouseUp 
CompareRows 
DragReorderRows 
HeaderPressed 
MouseMove 
MouseEnter 
MouseExit 
DropObject 
Open 
Close 


Wahle 
Alles auswahlen 


Um den Code-Editor eines Moduls oder einer Klasse zu offnen, fiihren Sie einen Doppelklick auf dem Namen des 
Moduls oder der Klasse im Projektfenster aus. Sie kinnen auch Bearbeiten aus dem Kontextmenti des Moduls oder der 
Klasse wahlen. Module sind eigenst’ndige Objekte, in denen Sie globale Konstanten, globale Methoden und globale 
Eigenschaften verwalten kénnen. Sie konnen auf die Konstanten, Methoden und Eigenschaften eines Moduls von jeder 
Stelle der Applikation aus zugreifen. Klassen sind wiederverwendbare Objekte, die auf bestehenden Objekten in REAL- 
basic basieren. Weitere Informationen finden Sie in den Kapiteln ,,Globale Funktionen durch Module“ auf Seite 229 und 
Wiederverwendbare Objekte durch Klassen“ auf Seite 304. 


Konfigurieren des Code-Editors 


Sie kdnnen verschiedene Voreinstellungen fiir den Code-Editor vornehmen. Offnen Sie dazu unter Windows und 
Mac OS Classic mit ,Bearbeiten/Einstellungen* (oder unter MacOSX mit  ,,REALbasic/Einstellungen“) die in 
Abbildung 142 gezeigte Dialogbox. Die Voreinstellungen fiir den Code-Editor sind auf zwei Dialogseiten verteilt: 


Code-Editor und Farben. 


Abb. 142: Der Einstellungen-Dialog 


Innerhalb der Code-Editor-Einstellungen k6nnen Sie folgende Einstellungen vornehmen: 


REALbasic IDE Voreinstellungen 


A] Sourcecode-Editor 


Code-Editor 


Font: Geneva iB} GréBe: 12 [is] 


Blende automatisch aus: 
ical Steuerelemente 


Fenster-Editor wv Eigenschaften 
) wv Farben 
Farben vw Auto-Vervollstandigen mit Standardschreibung 


a 
Online-Hilfe 


182 Programmieren mit Events und Objekten 


Font: Legt die Schriftart und -grfe ftir den Code-Editor fest. Fiir den Ausdruck konnen Sie getrennte Einstellungen 
vornehmen. Wahlen Sie dazu das Menii Drucken. 

Automatisches Ausblenden von Steuerelementepalette, Eigenschaftenfenster und Farbenfenster: Gemaf 
Voreinstellung blendet REALbasic Steuerelementepalette, Eigenschaftenfenster und Farbenfenster aus, wenn der 
Code-Editor aktiv ist. Fir jedes der genannten Elemente kGnnen Sie diese Einstellung zuriicknehmen. Wenn Sie sich, 
wahrend Sie im Code-Editor arbeiten, die Steuerelementepalette oder das Farbenfenster anzeigen lassen, knnen Sie 
Threm Code per Drag & Drop Farben oder Steuerelemente hinzuftigen. Wenn Sie eine Farbe aus dem Farbenfenster 
in den Code-Editor draggen, wird der entsprechende RGB-Wert in den Code eingefiigt. Wenn Sie ein Steuerelement 
aus der Steuerelementepalette in den Code-Editor draggen, wird wird dessen Name in den Quelltext tibernommen. 
Auto-Vervollstandigen mit Standardschreibung: Wenn Sie diese Einstellung wahlen, verwendet REALbasic zur 
Auto-Vervollstandigung die per Konvention festgelegte Grof/Kleinschreibung ftir Schliisselworter, wie sie in der 
Sprachreferenz vorgegeben ist. Ist diese Einstellung nicht ausgewahlt, belasst es REALbasic bei der von Ihnen getipp- 
ten Schreibweise. 


Auf der Dialogseite Farben konnen Sie die Farben ftir den Code-Editor festlegen. 


Abb. 143: Die Rubrik ,,Farben” in den REALbasic-Einstellungen 


REALbasic IDE Voreinstellungen 


E aan] Farben 


Carla cain [HM schlusselworter (Voreinstellungen ) 
Editor eval ali asad 
aI |__| Strings 

Sse a Zahlen 


Fenster-Editor [HM Real-Zahlen 


7) (IB uell-Text 
z Ly 


Farben = Kommentare 
2 || Auto-Vervollstandigen 
E = Eltern hervorheben 


Online-Hilfe 
— 


(Abbrechen ) (OK 


Sie k6nnen folgenden Elementen Farbe zuweisen: 


Schlisselw6rtern: REALbasic-Sprachelementen, wie zum Beispiel Kontrollstrukturen (If, While, etc.) und Datenty- 
pen (Integer, Color, Double, etc.). 

Strings: Strings, die Sie im Code einsetzen, wie beispielsweise Text, den Sie an eine MsgBox-Funktion tibergeben, 
um dem Benutzer einen Warnhinweis anzuzeigen. 


© Zahlen: Integer-Zahlen. 
© Real-Zahlen: Zahlen mit Dezimalstellen. Die Unterscheidung zwischen Real-Zahlen und Zahlen ist hier unabhangig 


vom deklarierten Datentyp. Wenn Sie beispielsweise die Variable i als Integer deklarieren und ihr anschliefSend den 
Wert i=5,76 zuweisen, dann greift REALbasic fiir ,,5,76“ auf die Einstellungen fiir die Real-Zahlen zuriick. 


© Quellcode: Variablen, Steuerelemente, Klassen, Operatoren, Methoden, Eigenschaften usw. 
© Kommentaren: Kommentar-Text. Kommentaren werden zwei Schrdgstriche(//), das Schliisselwort REM oder ein 


einfaches Anftihrungszeichen(‘) vorangestellt. 


@ Text, der automatisch vervollstandigt wurde: Text, der durch die Auto-Vervollstandigen-Option erzeugt wurde. 
e Eltern hervorheben: Wenn Sie die Vorteile der Steuerelemente-Hierarchie nutzen, hebt REALbasic das Eltern-Steu- 


erelement hervor, wenn Sie ihm ein untergeordnetes Steuerelement (Kind) zuordnen. 


Um eine Farbe zu dndern, klicken Sie auf ein Farbfeld. Die Farbauswahl erscheint. Wahlen Sie eine neue Farbe und besti- 
tigen mit OK. Um alle Farbeinstellungen wieder in den Ausgangszustand zu versetzen, klicken Sie auf den 
Voreinstellungen-Button. 
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Der Browser 


In der oberen Hierarchieebene werden die Namen der einzelnen Kategorien gezeigt, also Steuerelemente, Methoden, 
Eigenschaften etc. Klicken Sie auf das Dreieck vor einem Kategorienamen, um die Objekte der Kategorie anzuzeigen. 
Auf diese Weise kénnen Sie wiederum die zu dem Objekt geh6renden Events etc. aufklappen. In folgender Abbildung 
konnen Sie sehen, dass das Fenster ,TextFenster“ einen BevelButton namens KnopfFett hat: 


Abb. 144: Der Action-Event-Handler eines BevelButtons 


eee Code Editor (TextFenster) = © Code Editor (TextFenster) 
r aa Sub Action() { (@ Eigenschaften Sub Action = 
@ Events TextFeld.ToggleSelectionBold HW Events TemtF eld. ToggleSelectionBolal 
> & Menu-Handler End Sub Fy MenuHandler End Sub 
> © Methoden . _ 


[BB Methoden 

 & Notizen 

= & Steuerelemente 
® gad GroesseMenu 


> Ep Notizen 

¥ G@ Steuerelemente | 
> [5)GroesseMenue 

>  UWknopfrarbe 

v_ [4 |KnopfFett 


®& ( KnopFarbe 


Ga KnopfFett 


= Action a 
™) Close v Close 
@ EF} i!  DropObiect 


™ MouseDown, 
™ MouseEnter 
™ MouseE sit 

™ MouseMove 


Dieser BevelButton kennt folgende Event-Handler: 


Action 

Close 
DropObject 
MouseDown 
MouseEnter 
MouseExit 
MouseMove 
MouseUp 
Open 


Event-Handler sind innerhalb eines Objekts oder eines Steuerelements alphabetisch aufgelistet. Wenn Sie zum ersten 
Mal die Event-Handler fiir ein Steuerelement 6ffnen (zum Beispiel, indem Sie in einem Fenster auf ein Steuerelement 
doppelklicken), ist der voreingestellte Event-Handler ausgewahlt. Es kann sich dabei um den ersten Event-Handler in 
der Liste handeln (zum Beispiel der Action-Event-Handler bei einem PushButton), aber das ist nicht immer der Fall. Fiir 
das Canvas-Steuerelement beispielsweise ist der Paint-Event-Handler der automatisch ausgewahlte Event-Handler. 


Wenn Sie in der Objektliste auf den Event-Handler eines Steuerelements klicken, wird im Code-Editor der dazugehGrige 
Quelltext angezeigt. 
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Abb. 145: Code eines Event-Handlers 


"eee Code Editor (Fenster1) s 
> Eigenschaften Sub Action() — 
b> @P Events if EditField1 text="" then 
> Fy Menu-Handler Beep 
> BB Methoden MsgBox "Bitte zuerst einen Namen eingeben!" 
> ) Notizen else 
v tp Steuerelemente close 
> [© EditField1 end if 
am || End Sub 
Selektierter Event-Handler F2) Action 
“ Close 
“S DropObject 
“ GotFocus A 
“ LostFocus ’ 
=] fe ip 


Existiert zu einem Browser-Eintrag bereits Programmcode, werden der Browser-Eintrag und alle tibergeordneten Ein- 
trage fett hervorgehoben. In der obigen Abbildung enthdlt der Action-Event des OK-Knopfes Programmcode. Deshalb 
wird der Name des Event-Handlers, der Name des Steuerelements und dessen Kategorie fett dargestellt. So kann man 
schnell herausfinden, wo Codestiicke untergebracht sind, ohne manuell alle Eintrage in der Liste anklicken zu miissen. 


Leere Methoden anzeigen und verstecken 


Am unteren Rand der Objektliste gibt es vier Navigationskndpfe, mit denen man die gingigsten Operationen im 
Code-Editor auslésen kann. Der zweite Knopf zeigt und versteckt leere Methoden — also Methoden, fiir die kein Pro- 
grammcode existiert. Folgende Abbildung zeigt den Knopf in beiden Zustanden: 


Abb. 146: Die Knépfe zum Zeigen und Verstecken von Methoden 


Durch Klick werden leere Durch Klick werden leere 
Methoden versteckt Methoden angezeigt 


Wenn leere Methoden versteckt sind, k6nnen mehr Objekte angezeigt werden. Folgende Abbildung zeigt beide 
Zustande im Vergleich: 


Abb. 147: Der Code-Editor mit eingeblendeten und versteckten leeren Methoden 


"eee Code Editor (Fenster1) 4 "eee Code Editor (Fenster1) 
a GotFocus Sub Action() > Eigenschaften Sub Action() 
topirpces TextFenster.FullScreen=False > @ Events TextFenster.FullScreen=False| 
“\ MouseDown End Sub > — Menu-Handler End Sub 
“S| MouseEnter > FB Methoden 
“S| MouseExit > BNotizen 
“S\ MouseMove vy G Steuerelemente 
“5 MouseUp > @oOK 
“5 Open = Y  @ PushButton1 
Vv  &® PushButton2 =) Action 
=) Action ‘Vv &® PushButton2 
lose : = Action 
“S\ DropObject + 
El el =] fe 
Leere Methoden werden angezeigt Leere Methoden werden nicht angezeigt 
Sie miissen in der Objektliste scrollen, um alle Methoden Sie haben Zugriff auf alle Objekte und Events, die Code 
anschauen zu kénnen. Sie kénnen dadurch jedoch einer besitzen, ohne dass Sie in der Objektliste scrollen missen. 
leeren Methode Code hinzufiigen, indem Sie einfach auf Sie konnen aber auch kein Objekt expandieren, das keinen 
diese klicken. Code besitzt. Sie miissen, um einer leeren Methode Code 


hinzuzuftigen, zuerst in den Modus umschalten, dass leere 
Methoden angezeigt werden. 
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Obwohl Sie, wenn leere Methoden versteckt sind, diesen im Browser keinen Code hinzufiigen konnen, kdnnen Sie dies 
trotzdem tiber das Kontextmenti des Code-Editors erreichen. Der Wechseln auf“-Mentieintrag ist ein hierarchisches 
Untermenii, tiber das alle EventHandler, Methoden oder Eigenschaften des Fensters erreichbar sind. 


Abb. 148: Selektieren einer leeren Methode, wenn leere Methoden versteckt sind 


e808 Code Editor (Fenster1) 
EditField1 wird in der iam Sub Action() 
Objektliste nicht a £ pi TextFenster.FullScreen=Falsel 
angezeigt, da seine a mers a KeyDown: 
Methoden leer sind ... > BNotizen Events ba —OK > — GotFocus 
L~ _ EditField2 > LostFocus 
Nf ara EditField3 > MouseDown 
¥ @ PushBitton! PushButtonl > MouseUp 
... aber Sie konnen es Wa Action PushButton2 > —_ SelChange 
iber das Kontextmenii 
erreichen. ® Action EnableMenultems 
MouseMove 
MouseEnter 
MouseExit 
Open 
Close 
DropObject 


foResaCratS 
Mehr iiber Kontextmeniis finden Sie im Abschnitt ,,Kontext-Mentis“ auf Seite 195. 


Anmerkung: Wenn ein neues Steuerelement angelegt wird, erhalt es von REALbasic einen Namen. So erhalt zum Bei- 
spiel der erste PushButton, den Sie einem Fenster hinzuftigen, den Namen PushButton1. Ein solcher Name beschreibt 
den Objekttyp, aber nicht das Verhalten des Steuerelements. Sie sollten das Eigenschaftenfenster des Steuerelements 
dazu verwenden, Ihrem Steuerelement einen passenden Namen zu geben, der die Funktion des Steuerelements in der 
Anwendung wiederspiegelt. Der Browser zeigt neben jedem Steuerelement ein kleines Symbol an, um den Objekttyp 
oder die Klasse, von der das Steuerelement abgeleitet ist, zu verdeutlichen. 


Methoden im Code-Editor 


Event-Handler und Menu-Handler sind eigentlich auch Methoden, die speziell darauf ausgerichtet sind, bestimmte Auf- 
gaben wahrzunehmen. Wird eine Methode im Code-Editor angezeigt, dann besteht sie aus drei Teilen: Der Parameter- 
zeile, Ihrem Code und der Endzeile. 


Abb. 149: Die drei Teile einer Methode 


Parameterzeile Sub Action) 
if editField1.text="" then 
Fieep 
msgbox" Bitte zuerst einen Namen ei 
else 
close 
end if| 
Endzeile End Sub 


Ihr Code 


Die Parameterzeile 


Die Parameterzeile zeigt Sub (Kurzform von Subroutine/Unterprogramm), wenn die Methode keine Werte zuriickliefert, 
gefolgt vom Namen der Methode und dann folgen Klammern, in denen eventuelle Parameter stehen, die der Methode 
iibergeben werden. In der Abbildung sehen Sie, wie das beim Event-Handler MouseMove aussieht. Dieser wird immer 
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dann aufgerufen, wenn die Maus tiber ein Objekt geschoben wird. Es werden zwei Koordinatenwerte als Parameter 
iibergeben, damit man die Position der Maus feststellen kann. 


Abb. 150: Die Teile der Parameterzeile 


Name Parameter 


Sub MouseMovetX As Integer, ¥ As Integer) 


Mehr dazu siehe Werte an Methoden tibergeben“ auf Seite 166. 


Liefert die Methode einen Wert zurtick, dann heifst sie Function. Somit beginnt die Parameterzeile auch mit Function 
statt mit Sub. Sie benotigt auSerdem noch eine Typangabe, die bestimmt, welchen Typ der Wert hat, den sie zuriicklie- 
fert. In der Abbildung sieht man, wie das beim KeyDown Event-Handler eines EditField aussieht. Dieser wird immer 
dann aufgerufen, wenn der Benutzer in dem betreffenden EditField eine Taste driickt. Die Funktion liefert einen 
boole’schen Wert zurtick. Ist dieser True, dann verhilt sich REALbasic so, als ob die Taste nicht gedriickt worden ware 
und das entsprechende Zeichen erscheint auch nicht im EditField. Damit lassen sich Zeichen fiir EditFields ausblenden, 
wenn beispielsweise nur Zahlen erlaubt sein sollen. 


Abb. 151: Die Parameterzeile einer Funktion 


Typ des Riickgabewerts 


Function KeyDown(Key As String) As Boolean 
Mehr dazu siehe ,Riickgabe von Werten aus Methoden“ auf Seite 167. 


Eingabe des Programms im Code-Editor 


Wenn Sie den Programmcode eingeben, hilft Ihnen REALbasic ein wenig. Zum einen riickt es Ihre If..Then, 
Select...Case Konstrukte und Schleifen beim Tippen fiir Sie ein, damit Sie einfacher sehen konnen, welche Codezeilen 
sich innerhalb eines bestimmten Ausdrucks befinden. Es verwendet ferner blauen Text fiir Schltisselw6rter und Datenty- 
pen. Folgende Abbildung zeigt ein Beispiel hierzu. 


Auferdem erscheinen Kommentare, die Sie einftigen, in roter Schrift. Ein Textstring wird als nicht-ausftihrbarer Kom- 
mentar behandelt, wenn ihm ein Doppelslash (//), ein Apostroph (‘) oder das REM-Schliisselwort vorangestellt wird. 
Kommentare miissen nicht unbedingt in einer eigenen Zeile stehen, wie folgende Abbildung zeigt. 


Abb. 152: Ein Kommentar am Ende einer Zeile 


e808 Code Editor (TextFenster) 
> Eigenschaften ss 


Sub DateiSichern(Dateiname as String, SichernDialogZeigen As Boolean) 


> @@ Events Dim f as Folderitem 
> [=] Menu-Handler If Dokument=Nil or SichernDialogZeigen then 
v ®B Methoden f=GetSaveFolderltem("text" ,.Dateiname) 
"| DateiSichern If f<>nil then //wenn der Anwender Sichern angeklickt hat| 


Finden Title=f.name 
FontgréfeMeniiEins. | Dokument=f 
=) SetzeSchriftMenii Peay if 
> BE) Notizen ‘ 


If Dokument<>nil Then 
Dokument.SaveStyledEditField TextFeld 
TextWurdeGeandert=False 

End if 

End Sub 


> ( Steuerelemente 


SF) ie > 


Eine eigene Farbe wird auch ftir Textstrings verwendet, die Teil von ausftihrbarem Code sind. Dieser Text ist rosa, wie in 
folgender Abbildung gezeigt. 
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Abb. 153: Text in ausfiihrbarem Code ist rosa 


e808 Code Editor (TextFenster) 


ll separa ) Function CanceiCiose() As Boolean 
¥ 9 Events If TextWurdeGeandert Then 


~) Activate AenderungenSichern.ShowModal //Zeigt Dialog & wartet auf Eingaben 
*) CancelClose Select Case AenderungenSichern.KnopfGedrickt 

“S Close case "NichtSichern" 

S Deactivate case "Ab@rechen' 


“\ DropObject | 
EnableMenultems 


*\ KeyDown End Sel 
a MouseDown AenderunjgenSichern.close //Dialog schlie&en 
“\ MouseDrag End if 
“ MouseEnter a End Function 
“ MouseExit y 
=) le = 


Text in ausfiihrbarem Code hat eine andere Farbe als Kommentare 


Eine Code-Zeile im Code-Editor umbrechen 

Wenn Sie sehr lange Code-Zeilen eingeben, kdnnen Sie diese im Code-Editor umbrechen und auf zwei oder mehr Zeilen 
aufteilen. Beenden Sie eine solche Zeile mit einem Unterstrich und ftihren Sie die Zeile dann in der nachsten Zeile fort. 
Der REALbasic-Compiler wird nun erkennen, dass es sich bei der zweiten Zeile um eine fortgeftihrte Zeile handelt. 
Wenn Sie zum Beispiel einer Eigenschaft einen sehr langen String zuweisen, konnen Sie diesen String auf zwei Zeilen 
aufteilen. Wenn Sie den Unterstrich verwenden, wird die folgende Zeile eingeriickt, wie das folgende Beispiel zeigt. Der 
String, der hier zugewiesen wird, ist in zwei Zeilen aufgeteilt. 


SaveChangesMessageDlg.Explanation="If you don’t save now, you will"_ 
+"lose all that important work you did since your last coffee break. 


Abb. 154: Auf zwei Zeilen aufgeteilte Zeichenkette 


AAA Fensterl Quellcode 


PushButton1() 


Sub Open(Index As Integer) 
Caption="Dies ist ein Beispiel,"_ 
Close + "fiir eine umgebrochene Code-Zeile" 
“S| DropObject End Sub 
“ GotFocus 


“ LostFocus 

™) MouseDown 

“3 MouseEnter | 
“™) MouseExit 

™) MouseMove 


“S MouseUp 
Open 


| + > 


Beachten Sie, dass in diesem Beispiel der Unterstrich auSerhalb der Anftihrungszeichen steht und somit nicht zum 
String gehGrt. Desweiteren wird der+ Operator verwendet, um die beiden Teilstrings miteinander zu verbinden. Dies ist 
notwendig, damit der Compiler nicht annimmt, dass der Unterstrich zu den String gehGren soll. Wenn die Zeile, die Sie 
aufteilen wollen, keinen Text mit Anftihrungszeichen enthalt, ist die Verwendung des + Operators nicht notwendig. 


Auto-Vervollstandigung 


Wahrend Sie tippen, versucht REALbasic zu erraten, was Sie tippen mdchten und die Auto-Vervollstaindigung blendet in 
heller Schrift ein, was gemeint sein konnte. Wenn Sie die ersten Buchstaben eines REALbasic-Sprachenobjekts tippen — 
entweder ein eingebautes oder eine Variable, Methode oder Eigenschaft, die Sie erzeugt haben — zeigt REALbasic in hel- 
ler Schrift seine Vermutung an. Ist die Vermutung richtig, driicken Sie die Tab-Taste, um den Eintrag zu vervollstandigen. 
Liegt REALbasic falsch, tippen Sie einfach weiter. 
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Abb. 155: Auto-Vervollstandigung 


Vorher Lis tB ox | 
Nachher ListBox 1 


Wenn REALbasic mehrere passende Objekte findet, zeigt es stattdessen Punkte (...) an. Wenn Sie die Tab-Taste driicken, 
erscheint ein Kontextmenti mit den Vorschlagen und Sie konnen den passenden auswahlen. Dies zeigt folgende Abbil- 
dung. 


Abb. 156: Auswahl bei Auto-Vervollstandigung 


Sub Opent) Sub Open} Sub Open) Sub Open) 
accept| accept) AcceptFileDrop ACCEPt] AcceptFileDrop acceptPictureDrop 
End Sub End Sub | AcceptMacbataDrop End Sub | AcceptMacDataDrop End Sub 
AcceptPictureDrop AcceptPictureDrop 
AcceptTextDrop AcceptTextDrop 
Der Anwender tippt ,, accept”. Er driickt die Tab-Taste, um Er wahlt mit Hilfe der REALbasic vervollstandigt die 
Es erscheinen drei Punkte. das Kontextmenti aufzurufen. Cursortasten (auf/ab) den Eingabe. 


gewinschten Eintrag aus und 

driickt danach Return. 
Auto-Vervollstindigung funktioniert auch inmitten eines Ausdrucks. Ganz gleich, wo sich der Eingabecursor im Aus- 
druck befindet, k6nnen Sie immer die Tab-Taste driicken, um sich ein Popup-Menti mit méglichen Begriffen anzeigen zu 
lassen. In der folgenden Abbildung befindet sich der Eingabecursor nach dem ,,t“ in Text. 


Abb. 157: Auto-Vervollstandigung innerhalb eines Ausdrucks 


"eee Code Editor (Fenster1) 
B Ei hi : — 

& Eigenschaften Sub Action() 

> @ Events if EditField1.text="" then 

> Fy Menu-Handler Beep 

> © Methoden MsgBox "Bitte zuerst einen Namen eingeben!" 

> EB Notizen else 

¥ G@ Steuerelemente co @ © O Code Editor (enster1) 

> WW EditFieldi end i rs I = 

vy @OK |) end su @ Eigenschaften Sub Action() 
7 DNERISH > @ Events if EditField’ .t}p“sine 
a > Fy Menu-Handler Beep — 
ae x 
CO Close > BB Methoden MsgBox "Bil TextColor Namen eingeben" 
[) Dropobject > BB Notizen else TextFont 
| GotFocus 4 tinea TextSize 
Se igsiFocus ¥ (@ Steuerelemente oe TeatStyleData 

> WW EditFieldi ene il Top 
me Fle  apox End Sub 


Zh aceinw 


Auto-Vervollstandigung funktioniert auch bei selbstdefinierten Eigenschaften, Methoden, Funktionen und Events. 


Im folgenden Beispiel erzeugt der Anwender eine neue Eigenschaft fiir ein Fenster. REALbasic schlagt korrekt vor, dass 
es sich beim Objekttyp um ein FolderItem handelt. 


Abb. 158: Auto-Vervollstandigung im Dialogfenster Neue Eigenschaft 


Deklaration: Dokument As Folderitem 
_)} Private 
(Im Eigenschaften-Fenster zeigen 


Das Bearbeiten-Menii 


Wahrend Sie Code eingeben, sind die Standard-Befehle des Bearbeiten-Mentis wie Ausschneiden, Kopieren und Einfti- 
gen verfiigbar. Der Code-Editor unterstiitzt auch Undo und Redo (Shift-88-Z oder Shift-Strg-Z). Die Funktion ,,Komment- 
arzeilen“ (88-’ oder Strg-’) ist ebenfalls sehr niitzlich. Wenn sie auf Quelltextzeilen angewendet wird, werden diese 
auskommentiert, wenn sie auf Kommentarzeilen angewendet wird, werden diese in Code zuriick gewandelt. Folgende 
Abbildung zeigt das Bearbeiten-Menti wahrend der Code-Eingabe. 
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Abb. 159: Das Bearbeiten-Meniti 


Bearbeiten 


e 


> 
o 

@ Einfiigen eV 
4 

% 

io Alles auswahlen BA 
i 

‘a Kommentarzeilen #' 
@ Finden... > 


*® Neue Methode... 8M 
+ 
“(J Neue Eigenschaft... 7c9eP 
iS 
Neuer Menu-Handler... C88H 
*® Neue Notiz... C38N 


& Sperren... 
_4 Dateitypen... 
| Projekt-Einstellungen... 


Hinweis: Unter Mac OS X befindet sich das Einstellungen-Menu von REALbasic im REALbasic-Menu. 


Drag & Drop 

Der Code-Editor bietet volle Drag & Drop-Unterstiitzung. Innerhalb einer Methode k6nnen Sie: 

e Text bewegen: Markieren Sie den Text, der bewegt werden soll und draggen Sie ihn an die gewiinschte Position, die 
durch eine Einftigemarke angezeigt wird. 

@ Text kopieren: Markieren Sie den Text, der kopiert werden soll, halten Sie die alt-Taste gedriickt und draggen Sie ihn 
an die gewiinschte Position. 


Abb. 160: Codezeilen per Drag&Drop bewegen 


ece Code Editor (TextFenster) —— 
> @ Flgenschaften Function Action As Boolean 
> @ Events Dim stp as StyledTextPrinter 
y Py Menu-Handler Dim g as Graphics 
=) AblageDrucken Dim ps as PrinterSetup 


ke: Dim Seitenbreite as Integer 
=) AblageSichern Dim Seitenlange as Integer 
lageSichernunter ps=New PrinterSetup 
: communal ps.MaxHorizontalResolution=300 
= ps.MaxVerticalResolution=300 
If Seitenformat<>"" then //Seitenformat enthalt Werte 
BearbeitenFinden ps.SetupString=Seitenformat 
> BB Methoden | Seitenbreite=ps.width-36 
> BB) Notizen Seitenlange=ps.height-36 
> i] Steuerelemente //Drucken-Dialog mit den Werten aus Seitenformat 6ffnen 
g=openPrinterDialog(ps) 
else 
g=openPrinterDialog()//Dialog ohne Seitenformat-Angaben 6ffnen 
Seitenbreite=72*7.5 //Defaultbreite und -hohe 
Seitenlange=72*9 
|e 
i hat den Drucken-Dialog nicht abgebrochen v4 
stp=TextFeld.StyledTextPrinter(g,Seitenbreite-48 ) + 
EE} fe 


Sie konnen markierten Code auch in ein anderes Programm, das Drag&Drop unterstiitzt, draggen oder von dort per 
Drag&Drop holen. 


Sie konnen auch einen Text-Clip vom Schreibtisch in den Code-Editor draggen oder selektierten Text auf den Schreib- 
tisch draggen, um einen Text-Clip zu erzeugen. 
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Die Online-Referenz (88-1 oder F1 unter Windows) enthalt zahlreiche Beispiele mit REALbasic-Code. Jedes Beispiel ist 
von einem gepunkteten Rechteck umgeben. Jedes Code-Rechteck kann in den Code-Editor gedraggt werden. Sie kon- 
nen jedoch keine einzelnen Zeilen innerhalb des Rechtecks fiir das Drag & Drop selektieren. Folgende Abbildung zeigt 
ein Beispiel ftir einen Bereich, den man in das Code-Editor ziehen kann. 


Abb. 161: Ein Code-Beispiel in der Online-Referenz 


F eo ee Sprachreferenz 


[| »> ft dragitem KI (Suchen) 


Mussen dieses Dragitem im Event-handier ,Uragkow vorbelegen. siene ,Listdox steuerelement tur weitere |. 


‘Alpha 1 : 
Control Klasse Informationen tiber Auswahllisten. 
Dragltem Klasse Die Eigenschaften DropWidth und DropHeight haben unter Win32 keine Bedeutung und liefern O zuriick, 
ImageWell Steuerelem... auRer sie werden mittels NewDragltem gesetzt. 
ListBox Steuerelement Beispiele 
Me fim am Dieses Beispiel zeigt, wie ein Bild aus einem Canvas verschoben werden kann. Das Beispiel verwendet die M 


e Funktion, um auf das Canvas zu verweisen. Als Besonderheit verwendet das Beispiel einen 
benutzerdefinierten Cursor fur das Draggen. Das Beispiel geht davon aus, daf eine Resource-Datei namens 
Resources, die eine CURS-Resource mit ID 1044 enthalt, in das Projekt-Fenster gedraggt wurde. 
Function MouseDown(X As Integer, Y As integer) As Boolean | 
| | Dim d as DragItem 
d=NewDragitem(Me. Left ,Me. top,Me.width,Me.height) 
d.picture=Me. Backdrop 
d.MouseCursor=app.ResourceFork.getcursor(1044) 
| d.Drag //Erlaubt das Draggen 
Siehe auch da fur ImageWell, welches Drag&Drop zwi ageWells und PICT-Dateien zeigt _ 
oder fiir Clips auf dem Schreibtisch und das ListBox-Steuerelement, welches ein Beispiel fir Drag&Drop a 
zwischen zwei ListBoxen zeigt. ’ 
Folgendes Beispiel implementiert ein Anfasser*~Interface, in welchem ein Benutzer Zeilen aus der ListBoxl 


Window Klasse 


Zwischen Code-Editoren hin- und herdraggen 

Wenn Sie zwei oder mehr Code-Editoren geoffnet haben (zum Beispiel von einem Fenster und einem Modul), k6nnen 
Sie Eigenschaften oder Methoden von einem Code-Editor zum anderen draggen, indem Sie die alt-Taste gedriickt halten 
und eine Eigenschaft oder Methode vom einem Fenster ins andere ziehen. Events werden als Methoden kopiert. Sie 
k6nnen ebenso Code aus dem Code-Editor in den Browser-Bereich draggen. Indem Sie ein Code-Schnipsel in die Liste 
draggen, wird eine Methode ohne Riickgabewerte oder Parameter hinzugefiigt. Fiir den Fall, dass Sie eine einzelne Vari- 
able deklarieren, wird stattdessen eine Eigenschaft hinzugefiigt. 


Code uber Schnellkopie einfiigen 


Der Code-Editor bietet eine Méglichkeit, Text sehr einfach und schnell zu kopieren. Wenn Sie die Shift- und Alt-Taste 
driicken, dndert sich der Mauszeiger in eine Pipette .# . An der Stelle, an der sich der Schreibcursor befindet, kénnen 
Sie nun das Wort einfiigen, auf das Sie mit der Pipette klicken. Dies zeigt folgende Abbildung. 


Abb. 162: Code mit der Schnellkopie einfiigen 


Platzieren Sie die Eintugemarke 
an der gewiinschten Position. 
Klicken Sie mit gedriickter 
alt-Taste auf Ausdruck, den Sie 
einfiigen mochten. 


e Code Editor (TextFenster) 


BhtageDcoctan Sub shel) chs as String, Ersetzen as String) 
AblageSeltenformat Dim Fourditt as Integer 
FoundAt=inStr(TextFeld.SelStart, TextFeld.Text,Wert) 
If FoundAt>0 then //selektiere den Zieltext 


TextFeld.SelLengttt=Len(Wert) 
i panel .value=1 then // Ersetze-Panel 
TextFeld.SelText=Ersetzen 

End if a 
Else + 


Einftigemarke 


Code Editor (TextFenster) 


Sub Finden(Wert as String, Ersetzen as String) 

Dim FouficAt as Integer 

FoundAt=inStr(TextFeld.SelStart, TextFeld.Text,Wert) 

If FoundAt>0 then //selektiere den Zieltext 
TextFeld.SelStart=FoundAt| 
TextFeld.SelLength=Len(Wert) 

If FindenFenster.tabpanell .value=1 then // Ersetze-Panel 


DateiSichern S TextFeld.SelText=Ersetzen . 


End if m4 
Finden _ > Else < 


Nach dem alt-Klick erscheint der 
Ausdruck an der Einfiigemarke. 


v B Methoden 
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Einfiigen eines Eigenschafts- oder Methodennamens mittels Schnellkopie 


Die Auto-Vervollstandigen-Funktion macht es einfach, im Code-Editor Eigenschaften- oder Methodennamen einzuge- 
ben. Es geht mit der Schnellkopie aber noch einfacher: Klicken Sie einfach bei gleichzeitig gedriickter Shift- und alt-Taste 
einen Eintrag der Objektliste an, schon wird er an der Einfiigemarke eingefiigt. 


Abb. 163: Einfiigen des Eigenschaftsnamens AndererText mittels Schnellkopie 


(Eek s) Code Editor (Fenster1) 


v | eerie 7 Sub TextChange() 
(GiB AndererText a¥“ing AndererText 


> gp Events End Sub 
> Fy Menu-Handler 
> B Methoden 
> BB Notizen 
¥ G@ Steuerelemente 
Vv WI Textfeld 
™ Close 
“\ DropObject 
“ GotFocus 
5) keyDown 
“S LostFocus 
“S\ MouseDown 
“S| MouseEnter 
“S\ MouseExit 
“S\ MouseMove 
“S) MouseUp 
“5 Open 
“S\ SelChange 
© TextChange 


PS [F] fel > 


Drag & Drop von Farben 


Sie konnen Objekten, die Farbeigenschaften besitzen, Farben per Drag & Drop aus dem Farbenfenster in den Code-Edi- 
tor zuweisen. Dazu sollten Sie in den Einstellungen fiir den Code-Editor Blende automatisch aus: Farben deaktivie- 
ren. Ansonsten versteckt REALbasic automatisch das Farbenfenster, wenn Sie den Code-Editor verwenden. 


Wenn Sie eine Farbe draggen, enthilt das gedraggte Objekt eine Text-Reprasentation der Farbe in Form eines RGB-Wer- 
tes. Sie miissen lediglich Ihre Farbauswahl aus dem Farbenfenster an die passende Stelle im Code-Editor zu draggen. Am 
&c-Operator ist zu erkennen, dass es sich um eine Farbe handelt. 


Abb. 164: Eine Farbe per Drag & Drop zuweisen 


e088 Code Editor (Fenster1) e808 Code Editor (Fenster1) 
v @ Figenschaften ‘Sub Open() v @ Eigenschaften Sub Open() 
iS Andere ietas sting Textfeld.BackColor={[_J a Andere iertas sting Textfeld.BackColor=RGB(53,220,42)| 
> @ Events End Sub Ly > @ Events End Sub 
> Fy Menu-Handler > Fy Menu-Handler 
> BB Methoden @arahen > BB Methoden @araben 
> BB Notizen > B Notizen 


V (@ Steuerelemente 
v WoTextfeld 
Open 
TextChange 
> ©@& PushButtonl 


¥ G@ Steuerelemente 
vy WoTextfeld 
Open 
TextChange 
> ©@& PushButtonl 


zee aie 
Der BackColor-Eigenschaft wird eine Farbe zugewiesen, indem eine Beim Loslassen der Maustaste an der Einfiigemarke erscheint der dem 
Farbe vom Farbenfenster auf den Code-Editor gedraggt wird. Farbwert entsprechende Code. 


Drag & Drop von Steuerelementen 


Sie konnen dem Code-Editor den Namen jedes beliebigen Steuerelements durch Drag & Drop aus der Steuerelemente- 
palette hinzufiigen. Dazu miissen Sie in den Einstellungen fiir den Code-Editor Blende automatisch 
aus:Steuerelemente deaktivieren. Ansonsten versteckt REALbasic die Steuerelementepalette wenn Sie den Code-Edi- 
tor verwenden. 
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Um dem Code-Editor den Namen eines Steuerelements hinzuzuftigen, draggen Sie einfach ein Steuerelement aus der 
Steuerelementepalette in den Code-Editor, genauso als ob Sie einem Fenster eine Instanz eines Steuerelements hinzufii- 
gen wollten. Wenn Sie in diesem Stil vorgehen, fiigt REALbasic den Namen des gedraggten Steuerelements im Code ein, 
aber nicht den Namen einer Instanz dieses Steuerelement-Typs. Wenn Sie also einen PushButton in den Code-Editor 
draggen, dann fiigt REALbasic den Text PushButton neben der Einfiigemarke ein. Wenn Sie sich auf eine Instanz dieses 
Steuerelements beziehen mdchten (vorausgesetzt Sie haben beispielsweise PushButtons mit der Bezeichnung 
PushButton1, PushButton2 etc.), miissen Sie eine entsprechende Anderung im Text vornehmen. 


Sie konnen diese Programmfunktion dazu einsetzen, Instanzen von Steuerelementen per Code zu erzeugen. Das Serial- 
und das TCPSocket-Steuerelement sind beispielsweise in einem Fenster nicht sichtbar. Stattdessen kénnen Sie diese 
Steuerelemente tiber den Open-Event-Handler des Fensters erzeugen. Wenn Sie mdchten, kann Ihnen die Technik des 
Drag & Drop dabei behilflich sein, den Code zu schreiben, der eine solches Steuerelement instanziiert. 


Die Navigationsknopfe 


Der Code-Editor erlaubt es, von Methode zu Methode zu springen, indem man auf die Objekte und Events in der Objekt- 
liste klickt. REALbasic merkt sich dabei die Reihenfolge, in der die Methoden angezeigt wurden und macht es dadurch 
moglich, diese Schritte mit den Vorwarts- und Rtickwarts-Navigationskn6pfen zurtickzuverfolgen. 


Abb. 165: Die Navigationsknépfe des Code-Editors 


e008 Code Editor (TextFenster) 


AblageSeitenformat Sub DateiSichern(Dateiname as String, SichernDialogZeigen As Boolean) 
AblageSichare Dim f as Folderitem 

AblageSichernunter If Dokument=Nil or SichernDialogZeigen then 

BearbeitenAllesaus. f=GetSaveFolderltem(text" ,Dateiname) 

BearbeitenErsetzen - If f<>nil then //wenn der Anwender Sichern angeklickt hat 
BearbeitenFinden W | Title=f.name 

® Methoden Dokument=f 

DateiSichern End 


Finden 23 Endif 4 


=. ae If Dokument<>nil Then + 
“y is 
Riickwarts Vorwarts 


Diese Knépfe arbeiten genau so wie die Knépfe in einem Web-Browser. Der Riickwarts-Knopf ist wahlbar, wenn Sie zu 
einer zweiten Methode gehen, und der Vorwarts-Knopf ist wahlbar, nachdem Sie das erste mal den Riickwarts-Knopf 
benutzt haben. 


Ausschneiden/Kopieren und Anhangen 


Wenn Sie im Code-Editor arbeiten, gibt es eine niitzliche Erweiterung zum normalen Ausschneiden und Kopieren. Wenn 
Sie zusatzlich die Shift-Taste driicken, werden diese Befehle zu ,Ausschneiden und anhangen“ und ,Kopieren und 
anhingen“. Beide Befehle hangen den selektierten Text an den Text in der Zwischenablage an, statt den dort bereits vor- 
handenen zu ersetzen. 


Abb. 166: Ausschneiden/Kopieren und Anhangen 


Bearbeiten 


* Undo 98Z 
=> 


>@ Ausschneiden und anhangen 8X 


Kopieren und anhangen 28C 


@ Einfigen eV 
@ Léschen 


Durch diese Erweiterung kénnen Sie mehrere, nicht zusammenhangende Textteile sammeln und als Ganzes an der 


gewiinschten Stelle auf einmal einfiigen. Die Tastaturbefehle sind wie in der Abbildung ersichtlich $8-Shift-X bzw. 
38-Shift-C (Windows: Strg-Shift-X bzw. Strg-Shift-C). 
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Mehr Platz im Code-Editor 


Manchmal kann es sein, dass Sie mehr Platz bendtigen, aber das Fenster nicht vergréSern kénnen. Sie konnen die Schrift 
im Code-Editor verkleinern, indem Sie den Mentipunkt Bearbeiten/Einstellungen (unter Mac OS X REALbasic/ 
Einstellungen) aufrufen. Aufserdem konnen Sie den Trennbalken zwischen Editor und Browser nach links verschieben. 


Abb. 167: Trennbalken des Code-Editors 


eee Code Editor (TextFenster) 
P Heesscratee Function CancelClose() As Boolean 
v Peas If TextWurdeGeandert Then 
Activate AenderungenSichern.ShowModal //Zeigt Dialog & wartet auf Eingaben 
=) CancelClose Select Case AenderungenSichern.KnopfGedriickt 


“) Close case "NichtSichern" 
“ Deactivate case "Abbrechen" 
DropObject | Return True //Beenden abbrechen 
case "Sichern" //DateiSichern aufrufen, um Dokument zu sichern 


EnableMenultems : ‘ 
TextFenster(Window(1)).DateiSichern Window(1).Title,False 


KeyDown 


= End Select 
MouseDown AenderungenSichern.close //Dialog schlie&en 
™\ MouseDrag oe End if 
= a 
‘| MouseEnter ~ End Function 


Elid 
Trennbalken 
Wenn Sie den Trennbalken ganz nach links schieben, dann wird der Browser hinter einem kleinen Quadrat links unten 
im Editorfenster versteckt, das sich einfach wieder nach rechts ziehen lasst, um den Browser wieder einzublenden. 


Abb. 168: Code Editor mit verstecktem Browser 


e0ce Code Editor (TextFenster) 
Function CancelClose() As Boolean 
If TextWurdeGeandert Then 
AenderungenSichern.ShowModal //Zeigt Dialog & wartet auf Eingaben 
Select Case AenderungenSichern.KnopfGedriickt 
case "NichtSichern" 
case "Abbrechen" 
Return True //Beenden abbrechen 
case “Sichern" //DateiSichern aufrufen, um Dokument zu sichern 
TextFenster(Window(1)).DateiSichern Window(1).Title,False 
End Select 
AenderungenSichern.close //Dialog schlie&en 
End if 
End Function 


t 
Trennbalken 


Ist der Browser einmal zusammengeklappt, kann man ihn mit Shift-Tab wieder ausklappen und mit erneutem Shift-Tab 
verstecken. Dabei springt der Cursor auch gleich auf den Browser, wodurch man mit den Cursor-Tasten Objekte im 
Browser ansteuern kann. Shift-Tab reagiert nur so, nachdem das Browser-Fenster einmal auf diese Weise verkleinert 
wurde. Sonst wird Shift-Tab dazu verwendet, den Cursor vom Editorfenster in das Browser-Fenster zu setzen. Dies ist so, 
weil ein Benutzer, der die Maus dazu verwendet, im Browser Objekte zu selektieren, trotzdem den Fokus auf dem Editor 
haben will, so dass die nachsten Tastatureingaben weiterhin in Editorfenster gehen und nicht in den Browser. 


Anmerkung: Setzt man den Cursor auf eine Zeile, die mit einem Dreieck markiert ist, dann lasst sich das Dreieck mit der 
Befehlstaste (Windows: Strg-Taste) und den Cursortasten nach rechts oder links ein- und ausklappen. 


Mehrere Event-Handler gleichzeitig anzeigen 


Gemiifs Voreinstellung wird im editierbaren Bereich des Code-Editors nur der Code fiir einen Event-Handler oder eine 
Methode angezeigt. Dabei handelt es sich um den Event-Handler, den Sie im Browserbereich des Code-Editors ange- 
wahlt haben. Wenn Sie sich mehr als einen Event-Handler oder eine Methode anzeigen lassen mochten, dann k6nnen 
Sie den editierbaren Bereich des Code-Editors in zwei oder mehr Bereiche unterteilen, indem Sie die Trennleiste drag- 
gen. Die Trennleiste befindet sich direkt unter der Titelleiste und ist durch zwei horizontale Linien gekennzeichnet. 
Bewegen Sie den Mauszeiger tiber die Trennleiste, bis er sich in ein Symbol zum Verschieben der Trennleiste verwandelt. 
Draggen Sie anschliefsend die Trennleiste nach unten, um einen neuen abgetrennten Editierbereich anzulegen. Sie k6n- 
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nen auf diese Art und Weise mehrere Editierbereiche erzeugen. Weitere Editierbereiche konnen auch erzeugt werden, 
indem Sie auf die Trennleiste unter der Titelleiste doppelklicken. Wenn Sie auf die untere Trennleiste doppelklicken, wie 
in der unteren Abbildung gezeigt, schlieSen Sie den unteren Editierbereich. 


Abb. 169: Erzeugen eines zweiten Eingabebereiches im Code-Editor 


eee Code Editor Confers 
¥ (@ Steuerelemente Sub Action() 
>. Eee TextFeld.ToggleSelectionBold 
» (KnopfFarbe End Sub 
Vv [4)KnopfFett 
=) Action 
Selektieren Sie die Trennleiste ™\ Close 
an “5 DropObject 
und draggen Sie sie nach = aouseDewn 
unten. ™\ MouseEnter 
“S MouseExit 
™\ MouseMove 
“5 MouseUp 
™) Open 
[5] Knopfkursiv 4 
{\|KnopfUnterstrichen ¥ 
| lel 
eCc8 = Code Editor (TextFenster) 
: . si r 
REALbasic erzeugt einen hs @ _pamioarcnsil Sub Action() 
weiteren Eingabebereich und = xnopfFarbe a 
zeigt in diesem ebenfalls den ¥  [a)Knopfrett 
oben aktiven Event-Handler Action 
an. Um einen anderen C icc 
: op = 
Event-Handler bearbeiten zu ie are || Sub Actiond 
kénnen, setzen Sie die “S| MouseEnter TextFeld. ToggleSelectionBold 
Eingabemarke in den unteren “S| MouseExit End Sub 
Eingabebereich und wahlen —_escsage 
E ‘ “) MouseUp 
dann im Browser einen Bcces 
anderen Event-Handler aus. > Gilknopfkursiv r' 
> _| .|KnopfUnterstrichen ¥ 
f=) fed (> 


Indem Sie diesen Vorgang wiederholen, kénnen Sie weitere Unterteilungen vornehmen. Um den Event-Handler fiir den 
Editierbereich auszuwahlen, setzen Sie die Einftigemarke in den entsprechenden Editierbereich und wahlen den 
Event-Handler im Browserbereich aus. 


Sie k6nnen die Grd&e der einzelnen Editierbereiche variieren, indem Sie die Trennleiste zwischen zwei vorhandenen 
Editierbereichen nach oben oder unten verschieben. 


Abb. 170: Drei Eingabebereiche im Code-Editor 


e208 Code Editor (AenderungenSichern) 


¥ (@ Eigenschaften 


Bee Sub Action() 
(8 KnopfGedriickt as Sti. KnopfGedriickt="Abbrechen” 
> @ Events Hide 
> Fy Menu-Handler End Sub 
> B Methoden 
> BB Notizen "2 
¥ G Steuerelemente Sub Action() » 
7 qAbbrechen | pepicecrocne Sichern’ 
[B} Action End Sub 
> (icanvasi 
Vv @ NichtSichern 
= Action Sub Action() 
Vv ® Sichern KnopfGedriickt="NichtSichern"| 
= Action Hide 
End Sub 


SERCO 


Der aktive Editierbereich ist derjenige mit der Einftigemarke. Im obigen Beispiel befindet sich die Einftigemarke im obe- 
ren Editierbereich und zeigt den Action-Event ftir den KnopfFett an. Bei einem Klick des Benutzers auf einen anderen 
Event im Browser wiirde der Code dieses Events statt des KnopfFett-Codes angezeigt werden. Beachten Sie dies, damit 
Sie wahrend der Arbeit mit mehreren Editierbereichen nicht durcheinander kommen. 


Zwischen den Editierbereichen k6nnen Sie die Techniken Drag & Drop und Schnellkopie anwenden. 
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Ein Fenster aus dem Code-Editor heraus 6ffnen 
Wenn Sie im Code-Editor arbeiten, der zu einem Fenster gehort, knnen Sie das Fenster direkt aus dem Code-Editor her- 


aus Offnen. Das erste Icon in der horizontalen Scroll-Leiste |[F5}) Gffnet das Fenster. Wenn Sie im Code-Editor arbeiten, der 
nicht zu einem Fenster gehort (z.B. eine Klasse, die Sie Ihrem Projekt tiber ,,Ablage/Neue Klasse“ hinzugeftigt haben), ist 
das Icon nicht anwahlbar. 


Kontext-Ments 


Die Methoden im Browser k6nnen vom Code-Editor aus auch iiber Kontext-Meniis erreicht werden. Kontext-Meniis 
sind — wie der Name andeutet — automatisch auf den Kontext orientiert, in dem sie aufgerufen werden. Wenn Sie bei 
gedriickter ctrl-Taste (Windows: rechte Maustaste) auf die Arbeitsflache des Editorfensters klicken, werden die verwen- 
deten Komponenten aus dem Browser-Fenster in einem Meniti eingeblendet. Das ist besonders dann geschickt, wenn 
der Browser oder die leeren Methoden gerade ausgeblendet sind. 


Das Kontextmenti des Code-Editors ist ein hierarchisches Menii mit zwei Eintragen auf der obersten Hierarchieebene: 
Neu und Wechseln Auf. Das Neu-Menii hat ein Untermenii, iiber das Sie im Code-Editor ein neues Element anlegen 
konnen. Bei Code-Editoren, die zu einem Fenster gehdren, kénnen Sie eine neue Methode, Eigenschaft, einen neuen 
Menii-Handler oder eine Notiz hinzuftigen. Bei Code-Editoren, die zu einer Klasse gehoren, konnen Sie zusatzlich ein 
neues Event ins Leben rufen. 


Abb. 171: Kontext-Meniis im Code Editor 


e808 Code Editor (TextFenster) 
¥ (@ Steuerelemente Sub Action() 
DP (iGrosssanienus TextFeld.ToggleSelectionBold 
> End Sub 
v 
Steuerelemente > 
Events > 
“\ DropObject Menu-Handler ld — 
“| MouseDown || si Methoden > DateiSichern 
“\ MouseEnter : Eigenschaften > FontgréReMeniEinstellen 
“\ MouseExit Enq uN  SetzeSchriftMeni 
“\ MouseMove Finden 
“| MouseUp ————— 
“ Open 
> — [)Knopfkursiv a 
> _[4|Knopfunterstrichen ¥ 
& EF fe » 


Diese Meniibefehle stehen auch im Bearbeiten-Menii der IDE zur Verftigung. 


Uber das Wechseln Auf-Menii kénnen Sie im Editierbereich direkt die Event-Handler von Steuerelementen, 
Menu-Handlern, Fenster-Events, Fenster-Methoden und Fenster-Eigenschaften einblenden. Dabei listet das Wechseln 
Auf-Untermeniti immer alle Handler auf, die einem Steuerelement oder Fenster zur Verftigung stehen — nicht nur dieje- 
nigen, ftir die bereits Code existiert. 
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Abb. 172: Das ,,Wechseln Auf”-Kontextmenti des Code-Editors 


e0c8 Code Editor (Fenster1) 
(GS AndererText as string ‘’ Sub Open() 
> go Events Textfeld.BackColor=| 
> Fy Menu-Handler End Sub 
> B Methoden 
> BB Notizen 
v G® Steuerelemente 
Vv 1 Textfeld I 
e Wechselnauf > Steuerelemente ld Textfeld > KeyDown 
> - Neu > Events > PushButtonl => GotFocus 
> o imapewel Eigenschaften > ImageWell1 > LostFocus 
MouseDown 
: MouseUp 
El le» TextChange 
EnableMenultems 
MouseMove 
MouseEnter 
MouseExit 
DropObject 
Open 
Close 


Wenn Sie den Code-Editor in mehrere Arbeitsflichen aufgeteilt haben, k6nnen Sie den Inhalt einer ausgewahlten 
Arbeitsflache dndern, indem Sie den Textcursor auf die Arbeitsflache setzen, die verandert werden soll, und sich dann 
das Kontextmenii anzeigen lassen. 


Wenn sich der Mauszeiger im Code-Editor befindet, wahrend Sie das Kontextmenii aufrufen, dann erscheinen oberhalb 
der Neu und Wechseln Auf-Meniieintrage auch die Standard-Befehle des Bearbeiten-Menitis. Wenn Sie das Kontext- 
menii innerhalb des Code-Editors tiber einem Text aufrufen, erscheint iiber den Eintragen des Bearbeiten-Mentis auch 
den Meniieintrag Suchen nach“. Mit diesem kénnen Sie nach dem markierten Text oder dem Text unter dem Mauszei- 
ger suchen. Fiir weitere Informationen lesen Sie auch den Abschnitt ,,Objekt- und Variablen-Deklaration suchen“ auf 
Seite 197. 


Abb. 173: Das Kontextmenii des Code-Editors in der Arbeitsflache 


is) ee - Code Editor (Window1) 

P Eigenschaften Sub DataAvailable(Index As Integer) 

id yp events listbox 1.addrow "Socket " + str(index) +": " + me.ReadAll 
V G Menu-Handler me.write "Roger that, | got something from you" 

v B Methoden End Sub 


> BB Notizen 
¥ G Steuerelemente Tai 

a op 
Vv (BQ ListBox 4 Einfagen E = 

St“ Léscher iger) 

‘+ str(index) + " connected" 

| Alles auswahlen dex) + "connected!"| 

Et 


DataAvailable Steuerelemente > 

Error Neu > Events > 

SendComplete Ow  Menu-Handler > 
> 
> 


Sub Connected(Index As intelli DatenSenden 


ListBox1.addrow "Socket ' Eigenschaften 
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Suchen und Ersetzen 


Mit dem Suchen/Ersetzen-Dialog (Bearbeiten/Suchen/Suchen oder 38-F (Mac) bzw. Strg-F (Windows)) kénnen Sie 
bestimmte Texte in Ihrem Code suchen und durch andere ersetzen. Wenn Sie im aktuellen Code suchen, dann beginnt 
die Suche ab der Einfiigemarke. Wenn die Suche das Ende des Codes erreicht hat, wird sie am Anfang des Codes bis zum 
Erreichen der urspriinglichen Einftigemarke fortgesetzt. 
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REALbasic erlaubt die Suche im aktuellen Modul, auch wenn das Code-Editorfenster nicht gedffnet ist. In diesem Falle 
beginnt die Suchroutine in dem im Projektfenster ausgewahlten Objekt mit der Suche. 


Abb. 174: Der Finden/Ersetzen-Dialog ohne und mit erweiterten Optionen 
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Sie haben die Auswahl aus folgenden Suchkriterien: 
Projekt-Objekte: Sucht in den Namen der Projekt-Objekte im Projektfenster. Die Suche beschrankt sich dabei nicht auf 
Klassen und Fenster, sondern beeinhaltet alle darin enthaltenen Elemente inklusive Ordner, Resourcen, Bilder, etc. 
Steuerelemente: Durchsucht die Namen der Steuerelemente und zeigt sie im Code-Editor an. 
Deklarationen: Durchsucht Menu-Handler, deklarierte Eigenschaften des Benutzers und Methoden- Deklarationen 
inklusive der Parameter und zeigt sie im Code-Editor-Browser an. 
Quelltext: Durchsucht Ihren Code, so wie Sie ihn im Code-Editor eingegeben haben. Sie konnen den Suchbereich ein- 
schrinken, indem Sie einen anderen Option als ,,Gesamtes Projekt“ unter ,Suchbereich* auswahlen. 
Notizen: Durchsucht die Notizen. 
Auch der Suchbereich asst sich hier festlegen. 

Tabelle 5. Der Suchbereich 

Gesamtes Projekt Suchen und Ersetzen durchsucht das gesamte Projekt. 


Aktuelles Objekt = Suchen und Ersetzen durchsucht die Methoden des aktuellen Fensters, Moduls oder der aktuellen 
Klasse 


Aktuelle Methode Suchen und Ersetzen betrifft nur die aktuell angezeigte Methode 
Aktuelle Selektion Suchen und Ersetzen betrifft nur den aktuell ausgewahlten Code 


Mit den Knépfen in diesem Dialog k6nnen Sie nach dem nachsten Auftreten des Textes suchen, den im Code-Editor 
markierten Text durch den im Feld ,,Ersetzen“ ersetzen lassen oder alle Vorkommen im eingestellten Suchbereich erset- 
zen lassen. Die Tastaturbefehle sind $8-F (Windows: Strg-F) fiir ,Suchen“, 3-G (Strg-G) fiir ,Erneut suchen“ und 9-L 
(Strg-L) fiir ,Ersetzen und Suchen“. 


Objekt- und Variablen-Deklaration suchen 


Wenn Sie nach der Deklaration eines Objekts oder einer Variable suchen wollen, kGnnen Sie dies bequem tiber den 
Suche-Befehl im Kontextmenii des Code-Editors. Der Suche nach. . .“-Meniieintrag findet zum Beispiel eine Dim-Dekla- 
ration, eine Eigenschaft, eine Konstante oder eine Methoden-Deklaration. Dabei werden auch Code-Teile anderer 
Objekte im Projekt durchsucht, weshalb dieser Befehl sich bestens daftir eignet, Deklarationen zu suchen, die in einem 
anderen Objekt enthalten sind. 
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Um das Kontextmenti zu benutzen, platzieren Sie den Cursor in dem gesuchten Ausdruck und fiihren einen Cont- 
rol-Klick (Rechtsklick unter Windows) aus und wahlen den Mentieintrag ,Suchen nach. ..“. Befindet sich die Deklaration 
in einem anderen Objekt, wird ein neues Code-Editor Fenster gedffnet, um die gesuchte Deklaration anzuzeigen. 

Im folgenden Beispiel wird die Deklaration des Ausdrucks ,,ListBox1“ gesucht. Es stellt sich heraus, dass es sich dabei um 
ein Steuerelement handelt. 


e608 Fensterl Quellcode 
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REALbasic durchsucht zuerst den gedffneten Code-Editor. Falls es nicht fiindig wird, werden die anderen Teile des Pro- 
jekts durchsucht. Gibt es mehrere Deklarationen des gesuchten Ausdrucks, kénnen diese mit Hilfe des Mentieintrags 
Bearbeiten/Suchen/Weitersuchen nacheinander gefunden werden. 


Drucken des Programmcodes 


Um den Quelltext Ihres Programms auszudrucken, wahlen Sie Datei/Drucken (8-P oder Strg-P). In der folgenden Dia- 
logbox kénnen Sie naher bestimmen, was ausgedruckt werden soll. 


Drucken 


O Gesamtes Projekt 
O Aktuelles Objekt 
@ Aktuelle Methode 


(Abbruch ) @i@ricken 


Tabelle 6. Optionen der Druckdialogbox 


Option Beschreibung 
Gesamtes Projekt Ausdruck des gesamten Projektquelltexts. 
Aktuelles Objekt Ausdruck des Codes des gerade angezeigten Fensters, Objekts oder Moduls. 


Aktuelle Methode Ausdruck der gerade angezeigten Methode. 
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Uber Bearbeiten/Einstellungen (oder REALbasic/REALbasic Einstellungen unter Mac OS X) konnen Sie die Schrift- 
art und -grdfe fiir das Drucken einstellen. AufSerdem legen Sie hier fest, ob Schltisselworter fett gedruckt werden sollen 
und ob die ftir die Bildschirmdarstellung eingestellten Farben auch fiir den Ausdruck verwendet werden sollen. 


Abb. 175: Voreinstellungen fiir das Drucken 
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Export/Import von Programmcode 


Es ist einfach, von Ihnen angelegte Objekte zu exportieren oder zu importieren. Leicht kGnnen Quelltextteile, Fenster, 
Meniis, Sounds, Bilder, QuickTime-Filme, REAL-Datenbanken und Resource-Dateien in Ihr Projekt importiert werden. 


Externe Projektelemente 


Wenn Sie ein Objekt in mehreren Projekten verwenden mochten, k6nnen Sie es als externes Projekt-Objekt importie- 
ren. Das Objekt verbleibt auf der Festplatte. Anderungen, die von einem anderen Projekt an ihm vorgenommen werden, 
werden automatisch in das aktuelle Objekt tibernommen, wenn Sie es erneut 6ffnen. Sie konnen jedoch nicht mehr als 
ein Projekt gleichzeitig offnen, das auf das gleiche externe Objekt zugreift. Um einem Projekt ein externes Element hin- 
zuzufiigen, halten Sie die Befehls- und alt-Taste gedriickt (Ctrl-Shift unter Windows) wahrend Sie das Element vom 
Schreibtisch auf das Projektfenster ziehen. Der Name des externen Objekts wird im Projektfenster kursiv dargestellt. 


Importieren 


Um eine Datei in Ihr Projekt zu importieren, zichen Sie diese einfach vom Desktop auf Ihr Projektfenster und lassen sie 
dort fallen. Alternativ konnen Sie den Mentipunkt Ablage/Import verwenden und die Datei in der Dateiauswahlbox 
auswahlen. 
Wenn es sich um Code handelt, 6ffnen Sie die Methode, in die Sie den Code importieren méchten und ziehen Sie einen 
Text-Clip in die Methode hinein. Sie konnen nicht den Mentipunkt Ablage/Import verwenden, um Textdateien in eine 
Methode zu importieren. 


Eine Datei, die Sie dem Projektfenster hinzugefiigt haben, loschen Sie, indem Sie sie selektieren und die Back- 
space-Taste driicken oder ,,Bearbeiten/Léschen“ aufrufen. Sie konnen ein Objekt im Projektfenster auch léschen, indem 
Sie einen ctrl-Klick (Windows: Rechtsklick) darauf ausftihren und aus dem Kontextmenii ,,L6schen* auswahlen. 


Hinweis: Wenn Sie ein REALbasic-Objekt durch Ziehen in das Projektfenster importieren, ersetzt es automatisch ohne 
Nachfrage ein Objekt gleichen Namens. 

Manche Objekte werden in Ihr Projekt kopiert. Andere verbleiben auf der Platte und es wird nur ein Alias in das Projekt 
gesetzt, der auf diese Datei zeigt. Im Projektfenster wird ein Alias kursiv dargestellt. Im folgenden Beispiel wurden ein 
QuickTime-Film (Logo), ein PICT-Bild (Hintergrundbild) und mehrere Sound-Dateien in das Projekt importiert. 
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Abb. 176: Ein Projektfenster mit Aliasen von Dateien 
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Importierte Dateien 


Wenn Sie aus Ihrem Projekt ein eigenstandiges Programm erzeugen, werden die meisten dieser Dateien in dieses Pro- 
gramm kopiert. Folgende Tabelle zeigt die verschiedenen benutzbaren Dateitypen. 


Tabelle 7. Wie REALbasic Dateien behandelt 


Dateityp Kopie im Projekt? = Kopie in eigenstandigem Programm? 
Bitmap, PICT, JPEG, GIF Nein a 
Cursors Ja a 
PowerPC Shared Libraries Nein Nein 
QuickTime Movies Nein a 
REAL Datenbanken* Nein Nein 
REALbasic Classes Ja a 
REALbasic Menubars Ja a 
REALbasic Module Ja a 
REALbasic Windows Ja a 
Resources Nein a 
Sounds Nein a 
AppleScripts Nein a 


*Datenquellen wie z.B. REAL-Datenbanken erscheinen in normaler Schrift im Projektfenster, obwohl die Daten 
auSerhalb gespeichert sind. Die Verbindungsinformation zur Datenquelle wird im Projekt gespeichert. 


Weil REALbasic in Fallen, in denen das Original einer Datei auf der Platte bleibt, einen Alias verwendet, kann die externe 
Datei umbenannt und sogar verschoben werden. Bestenfalls beim Verschieben des Projekts und/oder der Referenzda- 
teien auf eine andere Platte kann es vorkommen, dass REALbasic die Dateien nicht mehr findet. In solchen Fallen fragt 
REALbasic nach dem Speicherort der vermissten Dateien. 


Wenn Sie ein Bild in Ihr Projekt importieren wird es in den Speicher geladen, sobald Sie das Programm starten, egal ob 
das Bild verwendet wird oder nicht. 


Wenn Sie viele grofse Bilder verwenden, kann es passieren, dass Ihr Programm sich seltsam verhilt oder ihm der Spei- 
cher ausgeht. Wenn Sie grofe Bilder verwenden, sollten Sie diese extern lassen und mit der GetFolderltem-Methode 
laden oder sie in einer PICT-Resource speichern und diese tiber die GetPicture-Methode von ResourceFork laden. Den- 
ken Sie daran, dass das Speichern in einer PICT-Resource nicht plattformtibergreifend funktioniert, so dass dies bei 
einem Programm fiir Windows nicht méglich ist. 


Alle Dateitypen auger PowerPC-Shared Libraries und REAL Datenbanken werden in das ausftihrbare Programm compi- 
liert. Sie mtissen diese also nicht beilegen, wenn Sie Ihr Programm weitergeben. 
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Exportieren 


Der Code fiir Methoden, Events, Konstanten, Eigenschaften etc. kann per Drag & Drop aus dem Code-Editor gezogen 
und als Textclip abgelegt werden. Zu diesem Zweck konnen Sie entweder Codezeilen im Editor selektieren oder den 
Namen eines Objekts im Browser auswahlen und dann draggen. Wenn Sie den Namen eines Objekts draggen, wird im 
Textclip der gesamte zum Objekt gehdrende Code abgelegt. 

AuSerdem kénnen Sie Quelltext in einer Textdatei ablegen oder im REALbasic-Format. Welches Format Sie wahlen, 
hangt von der spadteren Verwendung der Datei ab. Soll der Quelltext spater in einem Text (z.B. zur Dokumentation) ver- 
wendet werden, dann exportieren Sie ihn im Textformat tiber ,,Datei/Quelltext exportieren“ oder draggen Sie ihn direkt 
in das Programm, mit dem Sie die Dokumentation schreiben. 

Soll ein Fenster, ein Modul, eine Klasse oder eine Meniileiste zur spateren Verwendung in einem anderen REALbasic-Pro- 
jekt exportiert werden, konnen Sie das Objekt einfach aus dem Projektfenster auf den Desktop ziehen. Auf dem Desktop 
haben exportierte Objekte ihre eigenen REALbasic-Icons. 


Abb. 177: Icons exportierter REALbasic-Objekte 
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Sie kénnen REALbasic-Objekte aber auch tiber den Export-Befehl exportieren. Offnen Sie hierzu das entsprechende 
Objekt oder selektieren Sie es im Projektfenster. Wahlen Sie dann entweder im Ablage- oder im Kontextmenii des 
Objekts den Eintrag Fenster/Menti/Modul/Klasse exportieren. In der Dialogbox klicken Sie den Sichern-Knopf. 


Verschliisseln des Quelltextes 


Wenn Sie ein exportiertes Objekt an andere weitergegeben wollen, Ihr Quelltext aber nicht lesbar und bearbeitbar sein 
soll, rufen Sie den Mentipunkt Bearbeiten/Sperren auf, um Ihr Objekt zu schiitzen, bevor Sie es exportieren. Das Icon 
eines gesperrtes Objekts hat ein kleines Schltissel-‘Symbol in der rechten unteren Ecke. Wenn ein gesperrtes Objekt 
exportiert wird, unterscheidet sich sein Icon nicht von einem ungesperrten. Sie kénnen ein Fenster sperren und ent- 
sperren, so lange es sich in Ihrem Projekt befindet. Ein verschliisseltes Fenster kann nicht im Fenstereditor angezeigt 
werden und niemand hat Zugriff auf Code, der zu diesem Fenster oder einem seiner Steuerelemente gehGrt. Eine 
genaue Beschreibung, wie man Objekte schiitzt, finden Sie im Abschnitt ,,Fenster verschliisseln“ auf Seite 96. 


Beim Verschliisseln eines Objekts geben Sie ein Passwort an, mit dem Sie das Objekt spater wieder entschliisseln k6n- 
nen. 


Um ein Objekt zu verschliisseln, gehen Sie folgendermafsen vor: 
1. Wahlen Sie das Objekt aus, das Sie verschltisseln wollen und rufen Sie den Mentipunkt ,,Bearbeiten/Verschliisseln“ 
auf, Daraufhin erscheint der Verschliisseln-Dialog. 
Fensterl verschlisseln 


PaRwort: eee] 


Bestatigen: 


cal V3 Verschliisselung oder héher verw. 


( Abbrechen 


2. Geben Sie ein Passwort ein und bestatigen Sie dieses. 
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3. Wahlen Sie die Option ,V3 Verschliisselung oder hoher...“ nur, wenn Sie das Objekt mit REALbasic in Version 3 oder 
hdher verwenden. Wenn Sie diese Option nicht anwahlen, verwendet REALbasic die Verschliisselung der Version 2.1. 
Deaktivieren Sie die Option nur, wenn Sie das Objekt mit einer REALbasic-Version kleiner V3 verwenden wollen. 


Wichtiger Hinweis: Vergessen Sie nicht das Passwort! 
Das Icon eines verschliisselten Objekts erhalt im Projektfenster einem kleinen Schliissel in der rechten unteren Ecke. 


© ScreenshotProjekt 
{&. Fensterl 
(Gj Menileiste1 
(a) App 


Wenn ein Programmierer (einschlieflich des Autors) versucht, das Objekt zu editieren, wird folgender Dialog angezeigt. 


Dieses Objekt wurde vom Autor verschliisselt - es 
kann nicht gedffnet werden 


Um das Objekt editieren zu kénnen, miissen Sie es mit Hilfe des Passworts entschltisseln. 
Um ein Objekt zu entschliisseln, gehen Sie folgendermafen vor: 


1. Wahlen Sie das Objekt aus und rufen Sie den Meniipunkt ,Bearbeiten/Entschliisseln“ auf. Daraufhin erscheint der 
Entschliisseln-Dialog. 


Fensterl entschlisseln 


PaRwort: (sees 
( Abbrechen ) (Entschiiissein) 


2. Geben Sie das beim Verschliisseln verwendete Passwort ein und klicken Sie in ,,.Entschltisseln‘. 


Nach wenigen Augenblicken verschwindet der Schliissel im Icon des Objekts, womit angezeigt wird, dass das Objekt ent- 
schliisselt wurde. Wenn Sie das falsche Passwort eingeben, erscheint eine Fehlermeldung. 


Programmierung von Event-Handlern 


REALbasic-Programme sind Event-gesteuert. Das bedeutet, dass auf Aktionen des Benutzers reagiert wird. Sie haben 
bereits erfahren, dass es auSer den direkt vom Benutzer ausgeldsten Events auch noch indirekt ausgeloste Events gibt. 


Objektorientierte Programmierung 


Die Programmiersprache von REALbasic ist objektorientiert. Das bedeutet, dass der Code, der bei einem Event ausge- 
filhrt wird, Teil des Objektes ist, auf das sich das Event bezieht. Dieser Code heifst Event-Handler. 

Objekte konnen auch tiber eigene Methoden verfiigen. Dies gestattet Ihnen, in einem Objekt Code abzulegen, auch 
wenn dieser Code nicht direkt mit einem Event verbunden ist. Wird in einem Fenster ein Text eingegeben, so ist es sinn- 
voll, den zum Sichern dieses Textes benotigten Programmcode in einer Methode dieses Fensterobjekts unterzubringen. 
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Weil programmierte Objekte sich etwa so verhalten sollten wie Objekte der realen Welt, sollte man Code immer dem 
Objekt zuordnen, zu dem er gehért. Wenn Sie zum Beispiel mdchten, dass die Gre eines Fensters automatisch beim 
Offnen angepasst wird, dann ist es sinnvoll, den dazu geh6renden Programmcode im Open-Event-Handler des Fensters 
abzulegen. Soll aber ein Knopf in diesem Fenster in den Zustand Enabled oder Disabled gesetzt werden, wenn das Fens- 
ter sich Gffnet, dann gehGrt der Code dazu nicht in den Open-Event-Handler des Fensters, sondern in den 
Open-Event-Handler des Knopfes, denn dieser Codeteil betrifft nur den Knopf. Es wiirde genauso funktionieren, wenn 
Sie das anders machen, aber so ist es wirklich objektorientiert. Wollen wir doch mal ein Beispiel fiir die reale Welt an den 
Haaren herbeiziehen: Angenommen, eine Tir wird gedffnet und Sie nehmen das wahr, dann drehen Sie sich in Richtung 
der Tiir, um festzustellen, was dort vor sich geht. Die Sensorik, die Ihnen diese Wahrnehmung erméeglicht, ist ein Teil 
von Ihnen und nicht ein Teil der Tiir. 


Der klare Vorteil der korrekten Zuordnung von Code liegt darin, dass der Code immer bei dem Objekt verbleibt. Wenn 
Sie es zu einem anderen Zweck nochmal woanders im Programm verwenden mochten, dann ist daftir gesorgt, dass alle 
Funktionen des Objekts erhalten bleiben. Fehlt ein Teil des bendtigten Codes, miissen Sie ihn entweder erst aufstobern 
oder neu schreiben. 


Fenster (Windows-Objekt) 


Events 


Fenster bekommen jede Menge Events. Tabelle 8 listet die Events auf. Detailliertere Informationen finden Sie unter 
Window Klasse“ in der Sprachreferenz. 


Tabelle 8. Events der Window-Klasse 


Event Beschreibung 

Open Das Fenster soll gedffnet werden, wird aber noch nicht angezeigt. Auch die Steuerelemente 
empfangen ein Open-Event. Ein Fenster empfangt sein Open-Event, nachdem alle Steuerelemente 
ihr Open-Event empfangen haben. Diese Ausfiihrungsreihenfolge sollten Sie sich merken, da sie 
unter Umstanden eine grofe Rolle spielen kann. 

Close Das Fenster soll geschlossen werden, wird aber noch angezeigt. Auch die Steuerelemente 
empfangen ein Close-Event. Ein Fenster empfangt sein Close-Event, nachdem alle Steuerelemente 
ihr Close-Event empfangen haben. 


CancelClose Die Methode Quit wurde aufgerufen. Das Programm wird gleich beendet. Schickt der Event-Handler 
CancelClose den Wert ,,True”, dann wird die Quit-Methode abgebrochen und das Programm lauft 
weiter. 

Resized Die GroBe des Fensters wurde vom Benutzer oder durch Code, der die Height- oder 
Width-Eigenschaft des Fensters andert, verkleinert bzw. vergroBert. 

Moved Die Position des Fensters wurde vom Benutzer oder durch Code, der die Left- oder Top-Eigenschaft 


des Fensters andert, modifiziert. 


Paint Teile des Fensters miissen neu gezeichnet werden. Das passiert beim Offnen des Fensters, oder weil 
ein dartiberliegendes Fenster geschlossen wurde. Diesem Event-Handler wird ein Grafikobjekt als 
Parameter tibergeben, das die Grafik enthalt, die im Fenster dargestellt wird. Grafikobjekte haben 
eigene Methoden, um die in ihnen enthaltene Grafik zu zeichnen. Mehr dazu unter ,, Graphics 
Klasse” in der Sprachreferenz. 

EnableMenultems Solange das Fenster das oberste aller Fenster ist, wird immer dieser Event-Handler aufgerufen, 
bevor ein Ment in der Menileiste heruntergeklappt wird. Dies gibt Ihnen die Moglichkeit zu 
bestimmen, welche Meniipunkte gerade anwahlbar sein sollen. 
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Tabelle 8. Events der Window-Klasse (Fortsetzung) 


Event Beschreibung 


DropObject Eine Datei, ein Textstiick oder ein Bild wurde auf dem Fenster fallengelassen (nicht auf einem 
Steuerelement des Fensters, sondern auf der Fensterflache). Dem Event-Handler wird ein Parameter 
ibergeben, der ihm Zugriff auf dieses Objekt gibt. 


KeyDown Eine Taste, die vom Fenster behandelt werden muss, wurde gedriickt. Beispielsweise wird ein Druck 
auf die Tab-Taste nie an ein Steuerelement geschickt. Sie wird immer vom Fenster verarbeitet. Hat 
das Fenster keine Steuerelemente, die den Fokus erhalten konnen, wird jeder Tastendruck an das 
Fenster weitergegeben. Somit erzeugt dann jede Tastenbetatigung ein KeyDown-Event fiir das 
Fenster. Der Ubergebene Parameter entspricht dabei der gedriickten Taste. 


MouseDown Der Mausknopf wurde gedrtickt, aber noch nicht losgelassen. Soll das ignoriert werden, konnen Sie 
den Event-Handler ein ,,False” zurlickgeben lassen. Das Fenster verhalt sich dann so, als ob die 
austaste nicht gedrlickt worden sei. Die Mauskoordinaten (lokale Fensterkoordinaten) werden als 
Parameter geliefert. 


MouseUp Der Mausknopf wurde losgelassen. Die Maus war dabei noch innerhalb der Fensterflache. Dieses 
Event wird nicht aufgerufen, wenn MouseDown vorher nicht ,,True” zuriickgegeben hat, was 
logisch ist, denn wenn der Knopf nie gedriickt wurde, kann er ja schlecht losgelassen werden. Die 
Mauskoordinaten (lokale Fensterkoordinaten) werden als Parameter geliefert. 

ouseDrag Der Benutzer hat die Maus innerhalb des Fensters bewegt (die Maus befindet sich nicht Uber einem 
Steuerelement) wahrend der Mausknopf gedriickt war. Die Mauskoordinaten (lokale 
Fensterkoordinaten) werden als Parameter geliefert. 


louseMove Der Benutzer hat die Maus innerhalb des Fensters bewegt. Die Mauskoordinaten (lokale 
Fensterkoordinaten) werden als Parameter geliefert. 

ouseEnter Der Benutzer hat die Maus von einer Position auBerhalb des Fensters in das Fenster bewegt. 

ouseExit Der Benutzer hat die Maus von einer Position innerhalb des Fensters aus dem Fenster hinaus 
bewegt. 


Fenster offnen 


Es gibt zwei verschiedene Techniken, die Sie verwenden k6nnen, um Fenster zu 6ffnen. Welche Sie verwenden, hangt 
davon ab, was Sie mit dem Fenster vorhaben, wenn es ge6ffnet ist. Soll nur eine einzige Kopie des Fensters verwendet 
werden, dann konnen Sie es einfach 6ffnen, indem Sie eine Eigenschaft des Fensters andern oder seine Show-Methode 
aufrufen. 


Im folgenden Beispiel wird ein Fenster durch Zugriff auf eine Eigenschaft des Fensters gedffnet (in diesem Fall die 
Title-Eigenschaft (Fenstertitel) des Fensters aboutBoxWindow): 


aboutBoxWindow. Title="Uber dieses Programm" 


Wenn keine Eigenschaften des Fensters geandert werden miissen, kénnen Sie einfach die Show-Methode des Fensters 
aufrufen: 


aboutBoxWindow. Show 


Diese Methode funktioniert nur dann gut, wenn Sie nur eine Kopie des Fensters verwenden, da der Name des Fensters 
verwendet wird, um auf das Fenster zuzugreifen. Dies ist eine sehr statische Vorgehensweise. Wenn mehrere Fenster ver- 
wendet werden, dann wiirde REALbasic auf ein bereits ge6ffnetes Fenster zugreifen, statt eine weitere Kopie des Fens- 
ters zu Offnen. 


Soll Ihre Anwendung mehr als eine Kopie eines Fensters 6ffnen, dann erzeugen Sie mit dem New-Operator eine solche 
Kopie. Man spricht hier von einer neuen Instanz des Fensters. Sie bendtigen dazu eine Variable oder eine Eigenschaft 
vom Typ des Fensters. In der Variablen wird dann eine Referenz auf genau diese Kopie des Fensters angelegt, tiber die 
Sie auf das Fenster zugreifen konnen. Das funktioniert so: 
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Dim w as aboutBoxWindow 
w=New aboutBoxWindow 


Sie konnen dies verktirzen, indem Sie den New Operator in der Dim-Anweisung verwenden: 
Dim w as New aboutBoxWindow 

Diese einzelne Zeile dffnet einen ,,Uber.. .“-Dialog. 

Da aboutBoxWindow ein Objekt des Typs Window ist, konnen Sie auch so vorgehen: 


Dim w as Window 

w=New aboutBoxWindow 

Das ist vor allem dann niitzlich, wenn Sie mehrere verschiedene Fenster mit dem gleichen Programmcode dffnen moch- 
ten. Dies kann dann alles tiber dieselbe Variable stattfinden: 


Dim w as Window 

f theOptionkeyIsDown then 
w=New secretAboutBoxWindow 
Else 

w=New aboutBoxWindow 

End if 


In diesem Fall kénnte man mit Dim natiirlich auch zwei Variablen anlegen: Eine als secretAboutBoxWindow und die 
andere als aboutBoxWindow. Das ist aber nicht ganz so tibersichtlich und wird spatestens dann etwas miihsam, wenn Sie 
zehn Fenster benutzen. 

Weil Fenster Objekte sind, konnen Sie die Variable auch als Objekt definieren, so wie hier: 

Dim w as Object 

w=New aboutBoxWindow 

Bei Fenstern besteht normalerweise keine Notwendigkeit, diese als ,Object“ zu definieren. Hier ist .Window* schon 
etwas tibersichtlicher. Bei Steuerelementen ergibt sich das schon eher. Insbesondere wenn man Steuerelemente dyna- 
misch wahrend des Programmablaufs erzeugen mochte. Sie k6nnen in einer Variable sogar Referenzen auf mehrere 
Steuerelemente (auch solche verschiedenen Typs) speichern. Siehe auch ,Neue Instanzen von Steuerelementen dyna- 
misch erzeugen“ auf Seite 218. Mehr Informationen zum Gebrauch von Referenzen auf Fenster unter ,,Zugriff auf 
Bestandteile anderer Fenster“ auf Seite 216. 


Weitere Eigenschaften fiir ein Fenster anlegen 


Eigenschaften sind Informationen, die ein Objekt definieren und sind mit Variablen vergleichbar, die in Event-Handlern 
oder Methoden verwendet werden kénnen. Fenster haben viele vordefinierte Eigenschaften, wie beispielsweise Title, 
Width, Height, etc. Sie konnen auch eigene Eigenschaften fiir ein Fenster definieren, die Ihnen gestatten, ftir eine 
bestimmte Instanz eines Fensters Informationen zu speichern. Im Gegensatz zu Variablen geh6ren Eigenschaften einem 
Objekt (z.B. dem Fenster), so dass alle Event-Handler des Objekts darauf zugreifen konnen. Eigenschaften k6nnen sogar 
so deklariert werden, dass der Zugriff auch von auferhalb des Objekts méglich ist. Auf eine Variable, die innerhalb eines 
Event-Handlers tiber einen Dim-Ausdruck definiert ist, kann im Unterschied dazu von aufsen nicht zugegriffen werden. 


Anwendungsbeispiel: In einem Textprogramm kann der Anwender mehrere Dokumente gleichzeitig 6ffnen und bear- 
beiten. Jedes Dokument wird in einem eigenen Fenster angezeigt. Beim Beenden des Programms soll der Benutzer 
informiert werden, falls er Anderungen an seinen Dokumenten noch nicht gespeichert hat. Das Programm muss sich 
also den Anderungsstatus jedes einzelnen Dokuments merken. Dies kann man elegant realisieren, indem man das Doku- 
mentfenster mit der neuen Eigenschaft ,,Gedndert* versieht. Dabei handelt es sich um einen Boole’schen Wert, der auf 
True gesetzt wird, wenn das Dokument modifiziert wurde. Schlie&t der Benutzer das Fenster, dann priift der 
Close-Event-Handler des Fensters den Zustand der Fenstereigenschaft ,,Gedndert“. Eine solche Eigenschaft erzeugen Sie 
mit dem Mentipunkt Bearbeiten/Neue Eigenschaft. 
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Die Syntax zum Zugriff auf selbst definierte Eigenschaften ist identisch mit der bei den vordefinierten Eigenschaften ver- 
wendeten. Heifst das Fenster myDocumentWindow, dann wir die neue Eigenschaft wie folgt verandert: 


myDocumentWindow. Gedndert=True 


Die Eigenschaft Geandert sollte nur vom jeweiligen Fensterobjekt modifiziert werden k6nnen. Deshalb sollten Sie im 
oben erwahnten Dialog Neue Eigenschaft die Checkbox Geschiitzt aktivieren (siehe Abbildung 178). Auf geschiitzte 
Eigenschaften kann nur das Objekt zugreifen, dem sie gehéren. 

Wenn Sie eine Eigenschaft erzeugen, k6nnen Sie sie mit einem Wert vorbelegen. Dieser wird der Eigenschaft beim 
Erzeugen des Fensters automatisch zugewiesen. 


Der Geltungsbereich einer Eigenschaft 


Fiir jede Eigenschaft konnen Sie festlegen, ob nur Programmcode, der zum selben Objekt gehort, darauf zugreifen darf 
oder ob auch andere Methoden und Event-Handler auf die Eigenschaft Zugriff erhalten. Folgende Geltungsbereiche sind 
méoglich: 

Offentlich (ohne Einschrankungen): Auf eine Gffentliche Eigenschaft kann iiberall im Projekt zugegriffen werden, 
auserhalb des Objekts mittels Punkt-Notation (z.B. Fenster 1.Titel). 


Geschiitzt (nur aktuelles Fenster und Unterklassen): Auf eine geschiitzte Eigenschaft kann nur von den 
Event-Handlern und Methoden des Fensters und seiner Steuerelemente zugegriffen werden. Wenn Sie versuchen, 
auferhalb des Fensters auf die Eigenschaft zuzugreifen, erhalten Sie eine Fehlermeldung. 


Privat (nur aktuelles Fenster): Eine private Eigenschaft verhalt sich wie eine geschiitzte Eigenschaft. Allerdings kann 
nicht von Unterklassen des Fensters darauf zugegriffen werden. Ein Fenster, dass von einem anderen Fenster abgeleitet 
wurde, verfiigt nur tiber dessen 6ffentliche und geschiitzte Eigenschaften. 


Eine neue Eigenschaft ftir ein Fenster legen Sie so an: 
1. Offnen Sie im Code-Editor den Code des entsprechenden Fensters. 
2. Wahlen Sie Bearbeiten/Neue Eigenschaft. 


3. Geben Sie den Namen der Eigenschaft ein und definieren Sie ihren Datentyp. Heifst die Eigenschaft Geandert und 
soll vom Typ Boolean sein, dann tippen Sie Gecindert As Boolean ein. 


Abb. 178: Deklarieren einer Eigenschaft 
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4. Sie kénnen der Eigenschaft einen Vorgabewert zuweisen. Dazu verwenden Sie folgende Syntax: 
EigenschaftName AS Datentyp = Wert 
Fa 


WindowParameters(3) as Integer 


Is es sich bei der Eigenschaft um ein Integer-Array mit vier Elementen handeln soll, schreiben Sie folgendes: 


Sie konnen auch ein leeres Array als Eigenschaft deklarieren. Dazu geben Sie das Array mit leeren Klammern an: 


WindowParameters() as Integer 
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5. Wahlen Sie einen Giiltigkeitsbereich aus. AufSerdem k6nnen Sie durch Aktivieren der Checkbox Im 
Eigenschaftenfenster zeigen erreichen, dass die Eigenschaft im Eigenschaftenfenster des Fenster-Objekts 
erscheint, so dass Sie ihr auch dort einen Wert zuweisen k6nnen (und nicht nur mittels Programmcode). 


6. Klicken Sie ,OK“ und speichern die Eigenschaft. 


7. Im Code-Editor k6nnen Sie Notizen zu der Eigenschaft eingeben. Der eingegebene Text ist nicht ausftihrbar, auch 
wenn er giiltigen REALbasic-Code enthilt. Sie konnen der Eigenschaft hier keine Werte zuweisen. Dies knnen Sie in 
den Methoden und Event-Handlern des Fensters oder — falls es eine 6ffentliche Eigenschaft ist — auch in Methoden 
und Event-Handlern anderer Objekte. 


Ist die Eigenschaft geschiitzt oder privat, wird ihr Icon im Browser-Bereich entsprechend gekennzeichnet. 


Andern einer Eigenschaft 
1. Offnen Sie den Code-Editor fiir das Fenster, das die zu dindernde Eigenschaft enthilt. 
2. Klappen Sie im Browser die Liste der Eigenschaften des Fensters auf. 


3. Fiihren Sie einen Doppelklick auf die Eigenschaft aus oder selektieren Sie sie mit Einfachklick und rufen dann 
Bearbeiten/Bearbeiten (38-E bzw. Strg-E) auf. 


Abb. 179: ,,Eigenschaft andern” -Dialog 
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4, Fiihren Sie alle notwendigen Anderungen durch und klicken in ,,OK*. 

Loschen einer Eigenschaft: 

1. Offnen Sie den Code-Editor fiir das Fenster, das die zu léschende Eigenschaft enthiilt. 
2. Klappen Sie im Browser die Liste der Eigenschaften des Fensters auf. 

3. Klicken Sie einmal auf die zu léschende Eigenschaft, um sie zu selektieren. 

4, Wahlen Sie Bearbeiten/Léschen oder Kontextmenti/Loschen. 


Eigenschaften eines Fensters konnen vom Quellcode des Fensters oder seiner Steuerelemente tiber ihren Namen ange- 
sprochen werden. Der Name des Fensters ist dazu nicht notig, wie das folgende Beispiel zeigt: 

Title="Ein neues Fenster" 

Ist kein Fenstername angegeben, wird immer der Name des gegenwartigen Fensters angenommen. Wenn Sie wollen, 
k6nnen Sie immer mit der Self-Funktion auf die Eigenschaften des Fensters verweisen. Wenn Self im Event-Handler 
eines Steuerelements verwendet wird, verweist es auf das Elternobjekt, welches in diesem Fall das Fenster ist, in dem 
sich das Steuerelement befindet. Der Ausdruck 


Self.Title="Mein neues Fenster” 


verweist also ebenso auf die Title-Eigenschaft des Elternfensters. 
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Konstanten in einem Fenster anlegen 


Eine Konstante entspricht einer Eigenschaft, die tiber ihre gesamte Lebensdauer einen konstanten Wert enthalt. Wenn 
Sie eine Konstante erzeugen, weisen Sie ihr einen Wert zu, der spater nicht verandert werden kann. Sie kénnen eine 
Konstante auch in Ihrem Code erzeugen. Auch diese kann nicht durch eine Zuweisung geandert werden. 


Sie konnen Konstanten fiir Fenster, Module und Klassen erzeugen. Sie k6nne auch lokale Konstanten innerhalb einer 
Methode erzeugen. 


Der Gultigkeitsbereich von Konstanten 


Eine Fenster-Konstante besitzt genau wie eine Eigenschaft einen Giiltigkeitsbereich, der festlegt, welche Teile eines Pro- 
jekts auf sie zugreifen konnen: 


Offentlich: Die Konstante kann innerhalb des gesamten Projekts verwendet werden. Um die Konstante innerhalb des 
Objekts zu verwenden, das sie deklariert hat, mtissen Sie nur ihren Namen angeben, z.B. ,,Konstantenname“. 


Auf®erhalb des Objekts mtissen Sie die Punkt-Notation verwenden. Zum Beispiel ,Objektname.Konstantenname". 


Geschiitzt: Geschiitzte Konstanten konnen nur innerhalb der Methoden und EventHandler des Fensters oder dessen 
Steuerelemente verwendet werden. 

Privat: Eine private Konstante entspricht einer geschiitzten mit dem Unterschied, dass sie nicht ,,vererbt“ werden kann. 
Abgeleitete Fenster enthalten nur 6ffentliche und geschiitzte Konstanten. 


Lokalisieren einer Applikation mit Hilfe von Konstanten 


Wenn Sie mehrere Versionen Ihrer Applikation fiir verschiedene Plattformen und Sprachen erzeugen miissen, sollten Sie 
alle Textausgaben tiber Konstanten definieren. REALbasic erlaubt es Ihnen, einer Konstante mehrere verschiedene Werte 
zuzuweisen, die abhangig von der aktuellen Zielplattform und -sprache beim Compilieren eingesetzt werden. 


Dazu verwenden Sie die Tabelle im ,Neue Konstante“-Dialog. Dort bestimmen Sie, welchen Wert die Konstante fiir eine 
bestimmte Sprache und Plattform hat. Haufig wird es niitzlich sein, den Giiltigkeitsbereich global zu halten, damit alle 
Teile des Projekts darauf zugreifen knnen. Dies ist allerdings nur fiir Module méglich. Wenn Sie Text-Konstanten an 
einer Stelle sammeln, kénnen Sie sich Arger bei der Pflege dieser Konstanten ersparen. 

Dieser Vorgang wird detailliert im Abschnitt tiber Module beschrieben, aber er weicht nicht vom Vorgehen fiir eine Fens- 
ter-Konstante ab. Wenn Sie Konstanten verwenden wollen, um Fenster zu lokalisieren, folgen Sie den Ausftihrungen im 
Abschnitt ,,Eine Konstante einem Modul hinzuftigen“ auf Seite 232. 


Um eine Konstante einem Fenster zuzuweisen, gehen Sie folgendermafsen vor: 
1. Offnen Sie den Code-Editor fiir das Fenster, dem Sie eine Konstante hinzufiigen wollen. 
2. Wahlen Sie nun den Meniicintrag Bearbeiten/Neue Konstante. Daraufhin erscheint der Neue Konstante“-Dialog. 
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3. Bestimmen Sie die Bezeichnung, den Typ, den Giiltigkeitsbereich und den Wert der Konstanten. Falls Sie mehrzeili- 
gen Text eingeben wollen, klicken Sie auf den kleinen Button neben dem Eingabefeld, um den Text in einem separa- 
ten Dialog einzugeben: 


Wert bearbeiten 


(Abbrechen_) (550K) 


4. Benutzen Sie — falls erforderlich — die Lokalisierungstabelle, um der Konstanten ftir unterschiedliche Plattformen 
und Sprachen passende Werte zuzuweisen. 


5. Klicken Sie ,OK“ um die Konstante zu speichern. 


Methoden in einem Fenster anlegen 


Fenster kénnen auch eigene Methoden erhalten. Das hat den Vorteil, dass Code, der nur fiir ein bestimmtes Fenster ver- 
wendet werden soll, auch mit dem Fenster zusammen abgelegt werden kann. Wird in einem Fenster ein Dokument 
angezeigt, das der Benutzer andern kann, dann ist es sinnvoll den Programmteil, der sich um das Sichern des Dokumen- 
tes kiimmert, auch mit im Fenster unterzubringen. Wenn Sie also eine Methode AnderungenSichern im Fenster able- 
gen, dann ist dieser Code im Fenster enthalten, wenn Sie ein solches Fenster spater in einem anderen Projekt bendtigen. 


Parameter fiir Methoden angeben 


Mit Hilfe von Parametern kGnnen Sie Werte an eine Methode tibergeben. Diese kGnnen von der Methode verwendet 
werden und sogar modifiziert und zurtick gegeben werden. 


Parameter werden wie Eigenschaften deklariert (z.B. Alter as Integer). Um festzulegen, dass eine Methode Parameter 
annimmt, geben Sie deren Bezeichnung und Datentyp an. Méchten Sie mehrere Parameter tibergeben, trennen Sie 
diese mit einem Komma. Wenn eine Methode zum Beispiel zwei Parameter vom Typ Integer und String annehmen soll, 
wurden Sie die Parameter folgendermafsen deklarieren: 

myInt as Integer, myString as String 


Parameter werden innerhalb der Methode wie lokale Variablen behandelt. Die Methode kann den Wert eines Parameters 
andern, wie bei lokalen Variablen auch. mylnt verhilt sich also wie eine Integer-Variable, myString wie ein String. 


Es kénnen auch Arrays als Parameter tibergeben werden. Dazu fiigen Sie dem Parameternamen zwei leere Klammern an. 
Wenn Sie zum Beispiel ein Integer-Array mit vier Elementen an eine Methode tibergeben kénnen wollen, deklarieren Sie 
den Parameter folgendermafen: 

myInt() as Integer 


Da die Deklaration nicht die Grdf&e des Arrays vorschreibt, kann ein Array beliebiger Gr6fe tibergeben werden. Sie kon- 
nen die Anzahl der Elemente in einem Array mit Hilfe der Ubound-Funktion ermitteln. Wollen Sie einer Methode ein 
Array tibergeben, geben Sie einfach den Array-Namen ohne Klammern an. 

Sie konnen auch mehrdimensionale Arrays tibergeben. Auch wenn Sie die Anzahl der Elemente einer Dimension nicht 
angeben miissen, so miissen Sie doch die Anzahl der Dimensionen angeben. Dies tun Sie, indem Sie Anzahl der Dimen- 
sionen minus eins Kommata zwischen die Klammern schreiben. Wenn zum Beispiel aNames ein zweidimensionales 
Array ist, ware die Deklaration folgendermatsen: 

aNames(,) as String 

Es gibt noch eine weitere Méglichkeit, eine Reihe von Parametern an eine Methode zu tibergeben. Sie kénnen das 
ParamArray-Schliisselwort verwenden. Das ParamArray-Schltisselwort gibt an, dass eine unbestimmte Anzahl von Werten 
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eines bestimmten Typs tibergeben wird. Wenn Sie eine Methode schreiben, die eine Liste von Integer-Werten akzeptie- 
ren soll, wiirden Sie die Parameter so deklarieren: 

ParamArray nums as Integer 

Wenn Sie die Methode aufrufen, k6nnen Sie eine Liste von Integer-Werten tibergeben, die durch ein Komma getrennt 
sind (als waren sie separate Parameter). Zum Beispiel: 

myMethod(5,7,2,10) 

Innerhalb der Methode ist nums ein Integer-Array, welches die Werte enthilt. 


Riickgabewerte von Methoden 


Eine Methode kann auch einen Wert zuriickgeben. Solche Methoden werden Funktionen genannt. Sie kénnen eine 
Funktion genau so erzeugen wie eine Methode. Der einzige Unterschied ist, dass Sie den Datentyp des Riickgabewerts 
bestimmen miissen. 


Der Riickgabewert einer Funktion kann ein Array oder ein einzelner Wert sein. Wenn Sie ein Array zurtickgeben wollen, 
fiigen Sie der Bezeichnung des Datentyps einfach leere Klammern an. Wenn Sie beispielsweise ein Array von Inte- 
ger-Werten zuriickgeben wollen, schreiben Sie ,,Integer()“. Fir ein mehrdimensionales Array geben Sie Anzahl der 
Dimensionen minus eins Kommata innerhalb der Klammern an. Zum Beispiel ,Double(,)“ fiir ein zweidimensionales 
Double-Array. 


Damit eine Funktion einen Wert zuriick liefert, verwenden Sie das Schliisselwort ,,Return“. Werden in Ihrer Funktion bei- 
spielsweise zwei Integer-Arrays addiert und das Ergebnis in einer Variablen Total abgelegt, kGnnen sie dieses mit 
Return Total 


an den aufrufenden Code zuriick liefern. Bitte beachten Sie, dass mit diesem Ausdruck die Funktion verlassen wird. 
Code, der sich hinter diesem Ausdruck befindet, wird nicht ausgeftihrt. 


Der Giltigkeitsbereich von Methoden 


Wenn Sie eine Methode erzeugen, legen Sie auch fest, welche Teile des Projekts diese Methode erreichen konnen, um 
sie auszuftihren. Sie kénnen festlegen, ob die Methode nur innerhalb des Fensters und seiner Methoden und Event- 
Handler erreichbar ist, oder aus dem gesamten Projekt erreicht werden kann. Fiir den Giiltigkeitsbereich gibt es ver- 
schiedene Méglichkeiten: 


Offentlich: Die Methode kann innerhalb des gesamten Projekts verwendet werden. Dies ware zum Beispiel notwendig, 
damit ein MenuHandler des App-Objekts auf die Methode zugreifen kann. Um die Methode innerhalb des Objekts zu 
verwenden, das die Methode deklariert, greifen Sie tiber den Methodennamen auf sie zu. AuSerhalb verwenden Sie die 
Punkt-Notation (Fenster1.Methode). 


Geschiitzt: Geschiitzte Methoden k6nnen nur in dem Objekt, in dem sie deklariert wurden oder in abgeleiteten Klassen 
verwendet werden. Sie wiirden eine gschiitzte Methode verwenden, wenn diese mit Informationen des Fensters arbeitet 
und Sie nicht wiinschen, dass diese von aufsen aufgerufen werden kann. Die Methode wird tiber ihren Namen aufgeru- 
fen. Wenn Sie eine solche Methode auferhalb ihres Elternobjekts aufrufen, wird eine Fehlermeldung anzeigt. 


Privat: Private Methoden kénnen nur in dem Objekt aufgerufen werden, in dem sie deklariert wurden. Auch abgeleitete 
Klassen kGnnen nicht auf solche Methoden zugreifen, sondern enthalten nur 6ffentliche oder geschiitzte Methoden der 
iibergeordneten Klasse. Sie rufen private Methoden tiber ihren Namen auf. Wenn Sie eine solche Methode auferhalb des 
Elternobjekts aufrufen, wird eine Fehlermeldung angezeigt. 

So legen Sie eine neue Methode an: 

1. Offnen Sie den Code-Editor mit dem Code des entsprechenden Fensters. 


2. Wahlen Sie Bearbeiten/Neue Methode. 
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3. Geben Sie den Namen der Methode ein, legen Sie die Parameter fest und definieren Sie den Riickgabetyp, falls die 
Methode einen Wert zuriickliefern soll. 


Achten Sie darauf, dass Sie bei der Benennung der Methode kein reserviertes Wort verwenden. Verwenden Sie die 
Felder fiir die Parameter und den Riickgabetyp dazu, den Datentyp jedes Parameters und des zurtickgegebenen 
Werts zu deklarieren. Mehrere Parameter werden durch Komma voneinander getrennt (Beispiel: Alter as Integer, 
Name as String). 
Das Popup-Menii rechts vom Riickgabetyp-Feld enthalt die gebrauchlichsten Datentypen. Aber Sie konnen auch 
jeden anderen giiltigen Datentyp im Rtickgabetyp-Feld-Feld angeben. 
Fiir das Parameter-Feld gibt es eine Reihe weitergehender Optionen. Weitere Informationen finden Sie in den 
Abschnitten ,Einen Parameter als Wert oder Referenz tibergeben“ auf Seite 213, Vorgabewerte fiir Parameter“ auf 
Seite 214, ,,Setter Methods" auf Seite 215, ,,Zugriff auf Bestandteile anderer Fenster“ auf Seite 216 und ,,Konstrukto- 
ren und Destruktoren“ auf Seite 216. 

4, Wahlen Sie nun den Giiltigkeitsbereich der Methode aus. Weitere Informationen zu diesem Thema finden Sie im vor- 
herigen Abschnitt. Eine vollstandige Methoden-Deklaration sieht beispielsweise so aus: 


Abb. 180: Dialogbox ,,Neue Methode” 
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5. Wenn Sie damit fertig sind, klicken Sie auf OK, um die Methoden-Deklaration zu speichern. 


Sobald Sie OK geklickt haben, 6ffnet sich ein Editor-Fenster, in das Sie den Quelltext der eben deklarierten Methode 
eingeben konnen. Achten Sie darauf, dass die erste Zeile die Deklaration Ihrer Methode als Sub oder Function ent- 
halt. Innerhalb des Editors konnen Sie an dieser Deklaration nichts andern. Fiihren Sie im Browser einen Doppel- 
klick auf den Methodennamen aus, wenn Sie die Deklaration bearbeiten wollen. 


Wenn Sie die Methode als geschiitzt oder privat deklariert haben, wird dies im ,,Sub‘“- oder ,,Function“-Ausdruck ange- 
zeigt, wie in der Abbildung zu sehen ist. Wenn es eine 6ffentliche Methode ist, steht keine zusatzliche Bezeichnung 
im ,Sub‘- oder ,,Function“-Ausdruck. Das Icon einer geschiitzten oder privaten Methode enthalt ein Warndreieck. 
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Andern des Namens, der Parameter oder des Riickgabewerts einer Methode: 
1. Offnen Sie den Code-Editor fiir das Fenster, das die zu andernde Methode enthillt. 


2. Klappen Sie im Browser die Liste der Methoden des Fensters auf. 
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3. Doppelklicken Sie auf die Methode, oder wahlen Sie sie durch einen einfachen Mausklick aus und rufen anschlie- 
{send Bearbeiten/Bearbeiten (38-E oder Strg-E) auf, um die Methode zu modifizieren. 

Loschen einer Methode: 

1. Offnen Sie den Code-Editor fiir das Fenster, das die zu loschende Methode enthilt. 

2. Klappen Sie im Browser die Liste der Methoden des Fensters auf. 

3. Klicken Sie einmal auf die zu l6schende Methode, um sie zu selektieren. 

4, Wahlen Sie Léschen aus dem Bearbeiten- oder dem Kontextmenii oder driicken Sie Backspace. 


Eine Beispiel-Methode 
Folgendes Beispiel zeigt, wie man eine Methode schreibt und wie man sie aus einem Event-Handler im Fenster aufruft. 


Nehmen wir an, Ihr Programm muss dem Anwender die Méglichkeit bieten, Bilder zu 6ffnen und die Bilder unterschied- 
lichen Objekten zuzuweisen. Sie kénnen eine einfache Methode verwenden, um die Datei zu 6ffnen und das Bild 
zurtickzuliefern. Der Event, der die Methode aufruft, kann dann das Objekt einem Interface-Objekt zuweisen. 

Die Methode bekommt den Namen der zu 6ffnenden Datei als Parameter tibergeben und liefert ein Picture-Objekt. 
Daher wird sie als Funktion deklariert. 


Abb. 181: Die OpenPicture-Deklaration 
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Die Methode besteht aus folgendem Code (die Funktions-Deklaration kann nur tiber die Methode bearbeiten-Dialog- 
box gedindert werden). 


Function openPicture (s as String) as Picture 
Dim f as folderItem 
Dim p as picture 
f=GetFolderItem(s) 
if f.exists then 
p=f.openAsPicture 
else 
MsgBox "Ungtiltige Datei!" 
end if 
Return p 
End Function 


Mit dieser Methode k6nnen Sie dann Bilddateien 6ffnen, indem Sie ihr einfach den Pfad der Datei als String tibergeben. 
Folgende Zeile zeigt z.B. das Bild in einem ImageWell-Steuerelement an, indem das Bild der Image-Eigenschaft des 
ImageWell zugewiesen wird. 


Imagewel11.image=openPicture("Hintergrundbi ld") 
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Einen Parameter als Wert oder Referenz ibergeben 


Wenn Sie die Parameter der Methode definieren, k6nnen Sie zwischen zwei Parametertypen wahlen: Ubergabe als Wert 
(by value) oder als Referenz (by reference). Die Voreinstellung ist Ubergabe als Wert. Bei dieser Art erhilt die Methode 
den Wert als Parameter und kann mit diesem nattirlich Operationen ausftihren. Der Parameter wird wie eine lokale Vari- 
able behandelt. Sie miissen nichts Besonderes machen, um Parameter als Wert zu tibergeben. Die Ubergabe als Wert ist 
im vorangegangenem Beispiel gezeigt worden: Ein String-Parameter, der einen Pfadnamen enthilt, wurde an die 
Methode tibergeben und von dieser als Parameter in einem anderen Funktionsaufruf verwendet. 


Wenn Sie Ubergabe als Referenz verwenden, iibergeben Sie einen Verweis auf den Parameter, also einen Zeiger (Poin- 
ter). Wenn die Methode einen Parameter als Referenz bekommt, kann es den Wert des Parameters nach Belieben verin- 
dern und den gednderten Wert nach Beenden der Methode an Sie zurtickliefern. Folgende Methoden-Deklaration 
verwendet einen Parameter, der als Referenz tibergeben wird. 


Abb. 182: Einen Parameter als Referenz iibergeben 
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Das Schliisselwort ByRef in der Parameter-Deklaration bewirkt, dass der Parameter als Referenz und nicht sein Wert 
iibergeben wird. Die Methode selbst besteht nur aus folgender Zeile: 


d=d*d 
Die Methode andert also den Wert des tibergebenen Parameters. Solch eine Methode kann folgendermafen (z.B. im 
Action-Event eines PushButtons) aufgerufen werden: 


Sub Action() 
Dim Label as String 
Dim i as Double 
If Editfieldl.text <> "" then 
i=Val(Editfieldl.text) 
Label="Das Quadrat von "+EditFieldl.text+" ist " 
Quadriere(i) //Ubergabe als Referenz 
StaticTextl.Text=Label+Str(i)+"." 
Else //kein Wert eingegeben 
Beep 
SgBox "Bitte geben Sie in die Textbox eine Zahl ein." 
End if 
End Sub 


Wenn Sie diese Methode ausfiihren, werden Sie bemerken, dass sich der Wert von i nach dem Aufruf von Quadriere 
geandert hat. Das ist nicht méglich, wenn man ihn als Wert (by value) tibergibt. 


Sie k6nnen auch Arrays als Referenz tibergeben. Dazu miissen Sie nichts weiter angeben, da Arrays grundsatzlich als 
Referenz tibergeben werden. Es reicht also aus, wenn Sie einen Parameter als Array deklarieren: 


aNames() as String 
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Vorgabewerte fur Parameter 


Wenn Sie fiir ein Methode die Parameter deklarieren, k6nnen Sie wahlweise fiir jeden Parameter einen voreingestellten 
Wert angeben. Dies erreichen Sie, indem Sie in der Neue Methode-Dialogbox die Deklaration als Zuweisung schreiben. 
Wenn Sie z.B. den Parameter a als Integer deklarieren méchten, wiirden Sie in das Parameterfeld der Neue 
Methode-Dialogbox folgendes schreiben: 


a As Integer 

Um dem Parameter den Vorgabewert 10 zuzuweisen, wiirden Sie folgendes eingeben: 
a As Integer = 10 

Schauen Sie sich einmal die untenstehende Methoden-Deklarierung an: 


Abb. 183: Einem Parameter einen Vorgabewert zuordnen 
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Normalerweise miissen Sie der Methode meineMethode bei jedem Aufruf einen Integer-Wert tibergeben. Wenn Sie einen 
Vorgabewert angeben, kénnen Sie den Parameter im Aufruf weglassen. Wenn Sie den Vorgabewert benutzen wollen, las- 
sen Sie den Parameter einfach aus: 

meineMethode 

In diesem Beispiel wird nun der Vorgabewert von 1 verwendet. 

Wenn Sie einen anderen Wert verwenden wollen, tibergeben Sie diesen als ganz normalen Parameter: 
meineMethode(10) 

In diesem Fall wird meineMethode mit dem iibergebenen Wert 10 arbeiten und den Vorgabewert ignorieren. 

Sie konnen auch fiir mehrere Parameter Vorgabewerte angeben. So ist auch der folgende Ausdruck giiltig: 


Abb. 184: Zwei Parametern Vorgabewerte zuordnen 
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In diesem Fall k6nnen Sie die Methode folgendermafsen aufrufen: 
meineMethode 


Nun werden die beiden Vorgabewerte eingesetzt. Wenn Sie den Vorgabewert ersten Parameters iiberschreiben wollen, 
iibergeben Sie nur einen Wert: 
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meineMethode(100) 


In diesem Beispiel wird der Wert 100 als Parameter a tibergeben. Zum Uberschreiben des zweiten Parameters miissen Sie 
zwei Parameter tibergeben. Geben Sie dazu einfach den voreingestellten Wert des ersten Parameters an. 


,oetter Methods” 


Sie k6nnen auch mit dem Zuweisungs-Operator einen Wert an eine Methode tibergeben. Um z.B. den Wert 10 an eine 
Methode zu tibergeben, kénnen Sie folgenden Ausdruck verwenden: 

meineMethode=10 

Den Zuweisungs-Operator kGnnen Sie allerdings nur einsetzen, wenn Sie das Schliisselwort ,,Assigns“ beim Deklarieren 
der Methode verwenden. 


Abb. 185: Verwenden des Schliisselworts ,,Assigns” beim Deklarieren von Methoden 
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Wenn meineMethode wie im obigen Beispiel deklariert wird, dann konnen Sie ihr auf folgende Art und Weise einen Wert 
iibergeben: 

meineMethode = 10 

Sie konnen das ,,Assigns‘-Schliisselwort auch bei Methoden einsetzen, die mehr als einen Parameter erwarten. Dann 
miissen Sie ,,Assigns“ mit dem letzten Parameter verwenden. Sie kGnnen ,,Assigns“ nur fiir einen Parameter pro Methode 
einsetzen. Die folgende Deklaration einer Methode ist also korrekt: 


Abb. 186: Das Schliisselwort ,,Assigns” mit mehr als einem Parameter verwenden 
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Zum Aufruf dieser Methode verwenden Sie die folgende Syntax: 

Lautstarke(5,4)=10 

Wenn Sie das ,,Assigns“ Schliisselwort wie im obigen Beispiel einsetzen, konnen Sie die normale“ Syntax nicht mehr ver- 
wenden: 

Lautstarke(5,4,10)//funktioniert nicht 
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Konstruktoren und Destruktoren 


Ein Konstruktor ist eine Methode, die ablauft, wenn das Objekt, zu dem sie gehGrt, zum ersten Mal ins Leben gerufen 
wird. Normalerweise verwenden Sie einen Konstruktor, um ein Objekt zu initialisieren. Ein weiteres Beispiel fiir einen 
Konstruktor ware eine Methode, die die Rahmen- und Hintergrundfarbe eines Canvas-Objekts festlegt und initial ein 
Objekt im Canvas-Objekt zeichnet. 


Ein Destruktor ist eine Methode, die ablauft, wenn ein Objekt geloscht wird oder verschwindet, wie z.B. beim Schlie&en 
eines Fensters. 


Mit Hilfe des Code-Editors k6nnen Sie ganz einfach Konstruktor- und Destruktor-Methoden erstellen. Anstatt einen 
Namen fiir die Methode einzugeben, verwenden Sie einfach das Popup-Menti rechts vom Namenseingabefeld in der 
Neue Methode-Dialogbox. Hier haben Sie die Auswahl zwischen Konstruktor und Destruktor. Im Anschluss an Ihre 
Wahl erscheint der korrekte Name des Konstruktors oder Destruktors im Namenseingabefeld der Methode. 
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Ein Fenster (oder jedes beliebige Objekt) kann nur einen Konstruktor und einen Destruktor besitzen. Wenn Sie bereits 
einen Konstruktor fiir ein Objekt geschrieben haben, bietet das PopupMenu nur den Destruktor zur Auswahl an und 
umgekehrt. 


Zugriff auf Bestandteile anderer Fenster 


Objekte in anderen Fenstern konnen verwendet werden, indem Sie den Namen des Fensters angeben, in dem sich das 
betreffende Objekt befindet, und dahinter den Namen des Objekts. Selbstverstandlich geht das nur, wenn der Giiltig- 
keitsbereich des Objekts dffentlich ist. 

Sie verwenden die Syntax Fenstername.Objekiname. Wird in Fensterl ein Knopf geklickt, der dann die Find-Methode 
aufrufen soll, die sich im Fenster2 befindet, dann macht man das so: 

Fenster2.Find "Hallo" 

Die Eigenschaften anderer Fenster konnen ebenso verwendet werden. Wieder wird in Fenster1 ein Knopf geklickt. Dies- 
mal dndert er die Title-Eigenschaft von Fenster2: 

Fenster2.Title="Hallo Fenster 2" 

Im Falle eines Steuerelements kann der Bezeichnung des Steuerelements wiederum die Bezeichnung einer Eigenschaft 
folgen. Nehmen wir an, ein Button im Fenster1 wiirde bei einem Klick den Text eines Textfelds in Fenster2 dndern. Die 
Syntax sahe so aus: 

Fenster2.StaticTextl.Text="NeuerText” 

Also Fenstername.Elemeniname.Eigenschaft. 


Die Beispiele wiirden sich allerdings immer auf die erste Instanz von Fenster2 beziehen, egal wieviele Kopien des Fens- 
ters gedffnet sind. 

Soll von einem Fenster mehr als eine Kopie verwendet werden, so miissen Sie irgendwo eine Referenz auf die Fenster 
ablegen, damit das Programm immer weifs, auf welches Fenster sich eine Aktion beziehen soll. Wo Sie das tun, hangt 
ganz von der konkreten Anwendung ab. Angenommen, Sie haben mehrere Instanzen eines Fensters namens ,,DocWin- 
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dow* gedffnet, in denen jeweils der Text eines Dokuments angezeigt wird. Ein Knopf in diesem Fenster 6ffnet ein 
Suchenfenster, in dem ein Suchbegriff eingegeben werden kann. Die Suche soll in der Instanz des Fensters durchgeftihrt 
werden, in der der Suchen-Knopf gedriickt wurde. Da es mehrere Dokumentfenster geben kann, muss dem Suchenfens- 
ter mitgeteilt werden, in welchem Fenster gesucht werden soll, was man mit Hilfe einer Referenz auf das Fenster erle- 
digt. Zu diesem Zweck legen wir eine Eigenschaft an und nennen diese ,,Zielfenster“. Die Eigenschaft wird im 
Suchenfenster angelegt (denn das Suchenfenster benotigt diese Information) und als Typ fiir diese Eigenschaft verwen- 
den wir DocWindow. Nehmen wir mal an, dass es nur erlaubt ist, ein einziges Suchenfenster ge6ffnet zu haben (was man 
zum Beispiel dadurch erreicht, dass man das Suchenfenster modal macht), dann sieht die Syntax so aus: 

SuchenFenster. Ziel=Sel f 


Die Funktion Self liefert eine Referenz auf das Objekt selbst, von dem aus sie aufgerufen wurde. Da diese Zeile vom 
Suchen-Knopf in der entsprechenden Instanz des Dokumentenfensters aufgerufen wird, liefert Self also eine Referenz 
auf genau diese Instanz des Fensters und speichert sie in der Eigenschaft Ziel des Suchenfensters. Driickt der Benutzer 
dann spiter im Suchenfenster den Knopf ,,Finden“, kann der Code tiber die Referenz in der Ziel-Eigenschaft auf den Text 
im Dokumentfenster zugreifen und darin suchen. 


Abb. 187: Ein Fenster zum Suchen 


eee Suchen 


Suchen: ‘Halld 


(Abbrechen ) 


In der Abbildung hat das Fenster ein EditField, das wir ,Suchbegriff“ nennen. Hier gibt der Benutzer den zu suchenden 
Begriff ein. Nehmen wir an, dass das Dokumentenfenster tiber eine Methode namens Suchen verfiigt, die einen Suchbe- 
griff als Parameter erhalt und diesen dann im Dokument sucht und eine Fundstelle hervorhebt. Dann muss der 
Suchen-Knopf im Suchenfenster nur noch sehr wenig tun. Er muss namlich nur der Suchen-Methode des Dokument- 
fensters mitteilen, was zu suchen ist und diese aufrufen: 

Ziel.Suchen Suchbegriff.Text 

Die Eigenschaft Ziel, die dem Suchenfenster gehort, enthalt eine Referenz auf das Dokumentfenster, das das Suchen- 
fenster aufgerufen hat. Somit kann man diese Referenz prima verwenden, um die Suchen-Methode dieses Fensters auf- 
zurufen. Als Parameter wird die Text-Eigenschaft des EditFields mit dem Namen ,,Suchbegriff* tibergeben. 


Die Eigenschaft ,,Ziel“ bzw. die darin enthaltene Referenz auf ein Fenster kann auch dazu verwendet werden, um Eigen- 
schaften von Steuerelementen im Fenster zu verindern. Der Suchen-Knopf kénnte zum Beispiel auf den Zustand 
,disabled“ gesetzt werden, solange das Suchenfenster angezeigt wird: 

Ziel .Suchknopf.Enabled=False 


In unserem Beispiel wurde der Eigenschaft Ziel des Suchenfensters der Typ DocWindow zugeordnet. Soll das Suchen- 
fenster auch mit anderen Fenstern verwendbar sein, dann ist es geschickter, diesem den Typ Window zu geben. Das 
macht den Programmcode aber wiederum schlechter lesbar, da man dann nicht mehr aus dem Typ der Eigenschaft dar- 
auf schliefSen kann, dass sie sich auf DocWindow bezieht. Verwenden Sie den allgemeinen Typ Window also nur dann, 
wenn dies aus praktischen Griinden erforderlich erscheint. 


Steuerelemente 


Steuerelemente sind Objekte, die innerhalb eines Fensters erscheinen und die mit eigenem Code auf Ereignisse reagie- 
ren kdnnen. Sie konnen keine selbstprogrammierten Eigenschaften oder Methoden erhalten, wie es bei Fenstern még- 
lich ist. Dies geht nur dann, wenn Sie eine neue Klasse anlegen, die von einem bestehenden Steuerelement abgeleitet 
ist. 
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Dazu erstellen Sie zuerst eine neue Klasse, die auf einem der Steuerelemente basiert, und ftigen sie dem Projektfenster 
hinzu. Als SuperClass legen Sie Control fest und statten anschliefSend Ihre Klasse mit eigenen Methoden, Eigenschaften 
oder Event-Handlern aus. Um einem Fenster eine Instanz dieser Klasse hinzuzufiigen, draggen Sie sie vom Projektfens- 
ter auf einen Fenstereditor. Ein ausfiihrlicheres Beispiel erhalten Sie im Abschnitt Was ist eine Unterklasse?“ auf 
Seite 305. 


Events 

Steuerelemente, wie beispielsweise Fenster, empfangen Events und haben Event-Handler, die darauf reagieren konnen. 
Fiir jedes Event, auf das ein Steuerelement reagieren kann, gibt es einen entsprechenden Event-Handler. Die Sprachrefe- 
renz enthalt eine vollstandige Liste aller Events, auf die Steuerelemente reagieren konnen. Wenn Sie die Sprachreferenz 
lesen, sollten Sie im Hinterkopf behalten, dass jedes Steuerelement Eigenschaften und Events von seinem Eltern-Objekt 
erbt. So leiten sich zum Beispiel die meisten Steuerelemente von der RectControl-Klasse ab und haben demzufolge alle 
Events und Eigenschaften der RectControl-Klasse. 


Neue Instanzen von Steuerelementen dynamisch erzeugen 


Es gibt Situationen, in denen Sie nicht das gesamte Benutzer-Interface von vorneherein festlegen konnen, sondern ein- 
zelne Steuerelemente erst zur Laufzeit erzeugt werden miissen. Dies ist mit REALbasic mOglich, sofern das Fenster, in 
dem das geschehen soll, bereits ein Steuerelement desselben Typs enthalt. Das existierende Steuerelement kann dann 
als Vorlage fiir das zu erzeugende Element verwendet werden. Wollen Sie beispielsweise einen PushButton erzeugen, 
dann muss in dem Fenster ein Knopf vorhanden sein, den Sie klonen k6nnen. Da man alle Steuerelemente tiber die 
Eigenschaft “Visible” auch unsichtbar in einem Fenster ablegen kann, ist dies keine besondere Einschrankung. 

Nehmen wir an, Sie méchten den ,,PushButton1“ klonen, der bereits im Fenster vorhanden ist. 

So legt man zur Laufzeit eine Kopie des Steuerelements an: 

1. Offnen Sie das Eigenschaftenfenster von PushButton1 und setzen Sie den Index auf Null. 


Wenn neue Steuerelemente zur Laufzeit erzeugt werden, liegen sie in einem Array von Steuerelementen. 
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2. In dem Action-Event von PushButton1 reservieren Sie mit der Dim-Anweisung Platz fiir einen weiteren PushButton. 


3. Weisen Sie nun der Variablen eine neue Instanz des Steuerelements mit Hilfe des New-Operators zu. Dabei geben Sie 
die Bezeichnung des zu klonenden Steuerelements an. In unserem Fall ist das PushButton1. Der Action-EventHand- 
ler von PushButton1 sahe dann so aus: 

Dim pb as PushButton 

pb= New Pushbuttonl //Klonen von PushButtonl 

pb.Caption="Clone" //Beschriftung des Klons dndern, um Verwechselungen zu vermeiden 
pb.Left=me.Left+me.Width+10 //Den Klon ein Stlick nach rechts verschieben 


4, Wahlen Sie nun Debug/Programm starten. 
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Ihr Programm erzeugt bei einem Klick auf den Button ,,Original“ einen Klon. Die Caption-Eigenschaft der Variablen 
pb enthalt die entsprechende Beschriftung. 
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———————— 
Wenn Sie den Button Klon anklicken, erzeugen Sie rechts daneben einen weiteren Klon, und so fort. 


Da alle Steuerelemente, die Sie zur Laufzeit erzeugen, den Code mit dem Ursprungsobjekt teilen, ist es wichtig, dass 
man die einzelnen Steuerelemente zur Laufzeit unterscheiden kann. Dazu k6nnen Sie die Eigenschaft Index an den 
Action-EventHandler tibergeben. Nahere Informationen erhalten Sie im folgenden Abschnitt ,Gemeinsamer Code ftir 
ein Array aus Steuerelementen“ auf Seite 219. 


Wenn Sie zur Laufzeit unterschiedliche Steuerelemente erzeugen miissen, daftir aber nur eine Variable verwenden wol- 
len, wahlen Sie den Typ fiir die Variable, von dem sich die zu erzeugenden Steuerelemente ableiten. Wenn Sie zum Bei- 
spiel einen RadioButton und einen CheckButton erzeugen wollen, wahlen Sie den Typ RectControl fiir die Variable, da 
beide Button-Typen davon abgeleitet sind. Beachten Sie aber, dass Sie in dem Fall nicht auf die Eigenschaften eines 
CheckButton oder RadioButton zugreifen konnen. Um herauszufinden, welche tibergeordnete Klasse sich die Steuerele- 
mente teilen, beachten Sie deren Eintrage in der Sprachreferenz. 


Gemeinsamer Code fiir ein Array aus Steuerelementen 


Haben Sie mehrere Steuerelemente desselben Typs, die den selben Code verwenden sollen, legen Sie am besten ein 
Array mit den Steuerelementen (Control Array) an. In einem Array aus Steuerelementen ko6nnen zwei oder mehr Steue- 
relemente auf den gleichen Code zuriickgreifen. Ein Array aus Steuerelementen erzeugen Sie, indem Sie allen Steuerele- 
menten des Arrays denselben Namen geben (Name-Eigenschaft). Verwenden Sie dann die Index-Eigenschaft, um die 
einzelnen Elemente des Control Arrays zu identifizieren. Geben Sie einem Steuerelement einen Namen, der bereits ver- 
wendet wurde, fragt REALbasic, ob Sie ein Array mit diesen Steuerelementen anlegen mGchten. Zum Beispiel nennen Sie 
einen RadioButton ,,RB1“. Wenn Sie nun einen weiteren RadioButton ,,RB1“ nennen, wird REALbasic Sie fragen, ob Sie 
ein Control-Array erzeugen wollen. 


Abb. 188: Ein Array aus Steuerelementen erzeugen 
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Beachten Sie, dass die beiden Steuerelemente denselben Namen tragen und sich hauptsdchlich durch die Eigenschaft 
Index unterscheiden. Weitere Steuerelemente mit demselben Namen werden anhand der Eigenschaft Index durch- 
numeriert. 


Haben Sie eine Checkbox namens ,,Option“ angelegt und erzeugen eine zweite Checkbox, die Sie ebenfalls Option“ 
nennen, dann fragt REALbasic nach, ob Sie ein Array aus Steuerelementen erzeugen wollen. Die erste Checkbox erhalt 
dann den Index 0 und die zweite den Index 1. 


Alternativ konnen Sie Null als Wert der Index-Eigenschaft beim ersten Steuerelement eingeben und dann den Namen 
des ersten Steuerelements dem zweiten zuweisen. REALbasic weist dann automatisch der Index-Eigenschaft des zweiten 
Steuerelements 1 zu und so weiter. 


Im Code-Editor erscheint dann nur noch ein Steuerelement dieses Namens. Hinter dem Namen erscheinen Klammern, 
die anzeigen, dass es sich um ein Array handelt. Diese Steuerelemente werden nun alle vom gleichen Code gesteuert. 
Jedem Event wird die Index-Nummer des Steuerelements tibergeben, so dass Sie immer feststellen konnen, auf welches 
Steuerelement sich die Aktion gerade bezieht. 


Im folgenden Beispiel gehoren alle drei RadioButton-Steuerelemente zu einem Control Array. Alle drei Steuerelemente 
besitzen den Namen ,,rb1“ und werden tiber ihre Index-Eigenschaft unterschieden. Im Code-Editor wird der Wert der 
Index-Eigenschaft automatisch an jede Methode tibergeben. Im Action-Event-Handler stellen Sie z.B. fest, welcher der 
RadioButtons angeklickt wurde. 


Beachten Sie im folgenden Beispiel, dass der Index-Parameter automatisch zur Zeile der Methoden-Deklaration hinzuge- 
fiigt wird. Anstelle eines einfachen ,,Sub“ steht hier ein ,Sub Action(Index As Integer)“. Beim Parameter ,,Index handelt 
es sich um die Index-Eigenschaft aus dem Eigenschaftenfenster. 


Abb. 189: Ein Control Array und sein Action-Event-Handler 


— Format e808 Code Editor (Fenster1) 
O pvp > Eigenschaften Sub Action(Index As Integer) 
—r = > yp Events MsgBox "Sie haben "+RadioButton1 (index).Caption+" angeklickt!" 
} Laserdisc bb Menu-Handler End Sub 
O VHS > ‘) Methoden 
| = | > -.) Notizen 
v tp Steuerelemente | 
> [| GroupBox1 
Sobald der Anwender ¥ @ RadioButton1() 
einen RadioButton driickt, ®) Action 
wird der Wert des ) Close rf 
Index-Parameters gesetzt. =3 DropObject = 
=) Le > 


Durch einen einfache Case-Befehl konnen Sie feststellen, welcher Knopf gedriickt wurde und entsprechend reagieren. 
Das folgende Beispiel testet ein Control-Array mit drei RadioButton: 


Sub Action(Index as Integer) 
Select Case Index 
Case 0 
msgBox "you selected radio button "+str(index) 
Case 1 
msgBox "you selected radio button "+str(index) 
Case 2 
msgBox "you selected radio button "+str(index) 
End select 
End Sub 


Ersetzen Sie die msgBox-Aufrufe durch den Code, den Sie fiir den jeweiligen Button ausftihren wollen. 
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Drag & Drop 


Drag & Drop ist ein wichtiges Element im Benutzer-Interface vieler Programme. REALbasic unterstiitzt Drag & Drop ftir 
Text, Bilder, Dokumente und bestimmte Datentypen. 


Wenn etwas mit der Maus gezogen wird, wird ein Dragltem-Objekt erzeugt. DragItem-Objekte verftigen tiber eine 
Text-Eigenschaft, die verwendet wird, um gedraggten Text aufzunehmen, eine Picture-Eigenschaft ein gedraggtes Bild, 
eine MacData-Eigenschaft fiir bestimmte Datentypen und eine Folderltem-Eigenschaft, die auf ein gedraggtes Doku- 
ment, einen Ordner oder ein Anwendungsprogramm verweist. Manchmal miissen Sie selbst die Daten dort ablegen. In 
anderen Fallen sind diese dort automatisch vorhanden. 


Ein Dragltem kann mehr als ein Objekt enthalten und die Objekte miissen nicht unbedingt den gleichen Typ haben. 
Wenn Sie dem Anwender erlauben, solche Objekte zu draggen, miissen Sie zusatzliche Objekte innerhalb des Drag- 
Item-Objekts erzeugen und beim ,,Drop“ alle Objekte des Dragltems beriicksichtigen. 


Dragltems, die auf den Schreibtisch oder andere Anwendungsprogramme gezogen werden, verhalten sich wie erwartet: 
Ein Text, der auf den Schreibtisch gezogen wird, erzeugt eine Clipping-Datei. Ist das Dragltem ein Bild, wird entspre- 
chend eine Clipping-Datei mit diesem Bild erzeugt. 


Dragging von Text aus einem EditField 


Nur der Text in einem EditField, Zeilen einer ListBox, Teile eines Canvas-Steuerelements, Bilder eines ImageWells und 
Fenster konnen mit der Maus gezogen werden. Das klingt vielleicht wie eine drastische Einschrankung, ist es aber in der 
Praxis nicht. Diese Steuerelemente beherbergen namlich die einzigen Datentypen, mit denen andere Programme, die 
Drag & Drop unterstiitzen, etwas anfangen kénnen. 


Der Text in einem EditField kann automatisch gezogen werden, ohne dass spezieller Programmieraufwand dazu notig 
ist, vorausgesetzt, dass die Eigenschaft MultiLine des EditField aktiviert wurde. Dann wird automatisch ein Drag- 
Item-Objekt erzeugt und der Text landet in der Text-Eigenschaft des DragItem-Objekts. 


Dragging einer Zeile Text aus einer ListBox 


Damit der Benutzer eine Zeile aus einer ListBox ziehen kann, muss die EnableDrag-Eigenschaft der ListBox aktiviert wer- 
den. Beginnt der Benutzer eine Zeile aus einer ListBox zu ziehen, dann wird das DragRow-Event der ListBox aufgerufen. 
Diesem werden als Parameter das Dragltem tibergeben und die Nummer der Zeile, die gezogen wird. Sie miissen dann 
die Text-Eigenschaft des DragItem definieren. Da das DragRow-Event eine Funktion ist, miissen Sie ,,True“ zurtickliefern, 
damit das Draggen tiberhaupt stattfinden kann. Geben Sie ,,False“ oder keine Daten zuriick, dann wird das Draggen 
abgebrochen. Hier ein Beispiel ftir einen entsprechenden Event-Handler: 

Function DragRow(Drag as Dragltem, Row as Integer) 

Drag. Text=Me.List(Row)- chr(13)//Text ins DragItem schreiben 


Return True //Dragging erlauben 
End Function 


Dragging aus einem ImageWell 

Drag&Drop in oder aus einem ImageWell ist einfach. Wenn Sie aus einem ImageWell draggen wollen, miissen Sie: 

© ein Dragltem-Objekt mit der NewDragltem-Methode erzeugen, 

@ die Daten, die gedraget werden sollen, in die neue Dragltem-Instanz laden, 

© die Drag-Methode des Dragltems aufrufen, um das Dragging zu erlauben. 

Das Dragltem-Objekt ist der Container, der das gedraggte Bild enthalt. NewDraglItem ist eine Methode, die als Parameter 


die Ausmafe des Rechtecks entgegennimmt, die der Anwender sieht, wenn er mit dem Draggen beginnt. Die 
Drag-Methode wird aufgerufen, wenn die zu draggenden Daten in das Dragltem geladen wurden. Diesen Code platzie- 
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ren Sie in den MouseDown-Event-Handler des ImageWell, da der Anwender die Maustaste zu Beginn des Dragvorgangs 
driickt. 
Function MouseDown(X as Integer,Y as Integer) As Boolean 
Dim d as DragItem 
d=Me.NewDragItem(Me. left ,Me.top,Me.width,Me. height) 
d.picture=Me. image 
d.Drag //Erlaube Draggen 
End Function 


Dragging aus einem Canvas-Steuerelement 


Das Draggen des Backdrop-Images aus einem Steuerelement ist identisch mit dem Draggen des Bildes aus einem Image- 
Well. Sie platzieren den Code in den MouseDown-Event-Handler des Canvas-Steuerelements, da der Anwender das 
Dragging beginnt, indem er die Maustaste driickt. 

Function MouseDown(X as Integer,Y as Integer) As Boolean 

Dim d as DragItem 

d=NewDragItem(Me.Left, Me.Top, Me.Width, Me.Height) 

d.Picture=Me.Backdrop //liefert DragItem die Daten 

d.Drag //Erlaube Dragging 

End Function 
Wenn Sie das Drop programmieren, mtissen Sie die Picture-Eigenschaft des Dragltem einer Eigenschaft des Steuerele- 


ments zuweisen, das den Drag erhalt. 


Dropping 
Damit der Benutzer auf einem Fenster ein Dragltem, das er mit der Maus gezogen hat, ablegen kann, muss das Fenster 
signalisieren, dass es bereit ist, Daten auf diese Weise entgegenzunehmen. Es gibt vier Methoden, die jedes Steuerele- 
ment aufrufen kann, um die Art der Daten, die es entgegennimmt, zu definieren. Sie konnen angeben, dass das Steuere- 
lement oder Fenster mehr als einen Datentyp akzeptiert, indem Sie so viele Methoden der folgenden Tabelle verwenden 
wie notig: 


Tabelle 9. Methoden die den Datentyp steuern, der auf ein Steuerelement gezogen werden kann 


Name Beschreibung 
AcceptTextDrop Definiert, dass das Steuerelement Text entgegennimmt. 
AcceptPictureDrop Definiert, dass das Steuerelement Bilder entgegennimmt. 


AcceptFileDrop (Type) Definiert, dass das Steuerelement oder Fenster Dateien der angegebenen Typen 
entgegennimmt. Die Dateien missen im Dateitypen-Dialog des Projekts definiert sein. 

AcceptMacDataDrop _ Definiert, dass das Steuerelement oder Fenster Dateien des durch den vierbuchstabigen Type 

(Type) festgelegten Datentyps entgegennimmt, z.B. AcceptMacDataDrop("mytp"). Verwenden Sie 
dies, um Daten eines bestimmten Formats zu draggen/droppen oder festzulegen, wohin 
Textstrings gedroppt werden konnen. 


Normalerweise ruft das Steuerelement oder das Fenster im Open-Event-Handler eine oder mehrere dieser Methoden 
auf. Sind bestimmte Voraussetzungen nétig, damit ein Drag & Drop entgegengenommen wird, dann kann dies auch an 
anderer Stelle geschehen. In den meisten Fallen wird beim Fallenlassen eines Dragltems der DropObject-Event-Handler 
des Objektes aufgerufen, auf dem das Dragltem fallengelassen wurde. Das Dragltem wird dem Event-Handler tiberge- 
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ben. Hat das Objekt tiber die eben aufgeftihrten Methoden zuvor definiert, dass nur bestimmte Datentypen akzeptiert 
werden, kann Ihr Unterprogramm die Daten direkt aus dem Dragltem auslesen. Die Datentypen dazu sind folgende: 


Tabelle 10. Dragltem-Eigenschaften, die den Objekt-Typ anzeigen, der auf ein Steuerelement gezogen wurde 


Name Beschreibung 

Folderltem Reprdsentiert ein Anwendungsprogramm, einen Ordner oder ein Dokument, das fallengelassen wurde. 
Picture Enthalt ein Bild, falls eines fallengelassen wurde. 

Text Enthalt einen Text, falls einer fallengelassen wurde. 


MacData (Type) Macintosh-Daten des Typs, der durch den vierbuchstabigen Code angegeben wird. Daten dieses 
Formats werden als ein String zurlickgeliefert. 

PrivateMacData Daten (des angegebenen Typs), die gedraggt werden. Type ist ein vierbuchstabiger Resource Type oder 

(Type) vom Programmierer definierter vierbuchstabiger Code. Dieser Dateityp kann nicht auf eine andere 
Anwendung gedraggt werden. Wird nur auf dem Macintosh unterstiitzt. 


K6nnen mehrere Datentypen entgegengenommen werden, muss der DropObject-Event-Handler zunachst herausfin- 
den, welche Art von Daten fallengelassen wurde. Dazu bietet Dragltem folgende Funktionen: 


Tabelle 11. DragItem-Funktionen, die den Datentyp ermitteln 


Name Beschreibung 

FolderitemAvailable —_Liefert ,, True”, wenn ein oder mehrere Anwendungsprogramme, Ordner oder Dokumente 
fallengelassen wurden. 

PictureAvailable Liefert ,, True”, wenn ein Bild fallengelassen wurde. 

TextAvailable Liefert ,, True”, wenn ein Text fallengelassen wurde. 

MacDataAvailable _Liefert ,, True”, wenn Macintosh-Daten des durch den vierbuchstabigen Type-Code angegebenen 

(Type) Typs gedroppt wurden. 


Dropping von Objekten auf EditFields 


Text, der auf mehrzeilige EditFields gedroppt wird, wird automatisch an der Stelle der Einftigemarke platziert. Der Drop- 
Object-Event-Handler des EditFields wird nicht aufgerufen. Bilder und Dateien, die auf ein mehrzeiliges EditField 
gedroppt werden, lésen jedoch den DropObject-Event-Handler aus. Wenn Sie z.B. eine Textdatei in ein EditField drop- 
pen wollen und der Inhalt im EditField erscheinen soll, miissen Sie den Inhalt der durch das Folderltem des 
DragItem-Objekts spezifizierten Datei einlesen und in das Editfield einfiigen. 


Im folgenden Beispiel wurde ein EditField darauf vorbereitet, gedroppte Text-Dateien entgegenzunehmen. Me ist die all- 
gemeine Schreibweise, um sich auf das Objekt zu beziehen, zu dem der Event-Handler gehort: 


Sub DropObject(Obj as DragItem) 
If Obj.FolderItemAvailable Then 
Obj.FolderItem.OpenStyledEditField Me 
End If 
End Sub 


Da mehr als eine Datei gleichzeitig fallengelassen werden konnte, miissen Sie mit der Nextltem-Funktion priifen, ob 
eventuell noch eine weitere Datei folgt. Die Nextltem-Funktion dndert auSerdem die Folderltem-Eigenschaft des Dragl- 
tem auf die nachste Datei. Andert man das letzte Beispiel entsprechend ab, sieht es so aus: 


Sub DropObject(Obj as DragItem) 
If Obj.FolderItemAvailable Then 
Do 
Obj. FolderItem.OpenStyledEditField Me 
Loop Until Not Obj.NextItem 
End If 
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End Sub 


Objekte auf ListBoxen ablegen 


Wenn Sie Text auf eine ListBox draggen wollen, miissen Sie die Listbox entsprechend praparieren, indem Sie folgende 
Zeile in ihren Open-Event-Handler platzieren (oder in einen anderen Event-Handler, der vor der Drag&Drop-Aktion auf- 
gerufen wird): 

Me .AcceptTextDrop 

Danach miissen Sie der ListBox mitteilen, welche Aktion mit dem gedraggten Text ausgeftihrt werden soll. Dies machen 
Sie in deren DropObject-Event-Handler: 


Folgender DropObject-Event-Handler stellt fest, ob das gedraggte Objekt Text enthilt. Ist dies der Fall, erzeugt er eine 
neue Zeile und weist dieser die Text-Eigenschaft des gedraggten Objekts zu. 
Sub DropObject (Obj as DragItem) 
If Obj.TextAvailable then 
Me. AddRow(obj. text) 
end if 
End Sub 


Dropping von Objekten auf ImageWells und Canvas Steuerelemente 


Um dem Anwender das Dropping eines vom Schreibtisch gedraggten Bildes oder PICT-Dokuments zu erlauben, fiigen 
Sie folgende Befehle in den Open-Event-Handler des ImageWell- oder Canvas-Steuerelements ein: 


Me.AcceptPictureDrop 
Me.AcceptFileDrop("image/x-pict") 


Der zweite Befehl setzt voraus, dass Sie Ihrem Projekt tiber Bearbeiten/Dateitypen den PICT-Dateityp hinzugefiigt 
haben. 


Danach muss man dem ImageWell oder Canvas mitteilen, was es mit dem jeweiligen Dragltem machen soll. Dies 
geschieht im DropObject-Event-Handler. Folgendes funktioniert bei einem ImageWell: 


Sub DropObject (Obj as DragIte 
If Obj.PictureAvailable then 
ImageWel11.Image=Obj.Picture 
Elseif Obj.FolderItemAvailable then 
me.image=Obj.FolderItem.OpenAsPicture 
End if 

End Sub 


Zunichst wird getestet, ob das Dragltem ein Bild oder eine Datei (Folderltem) ist. Handelt es sich um ein Bild, wird die 
Image-Eigenschaft des Dragltems der Image-Eigenschaft des ImageWell zugewiesen. Wenn es ein Folderltem ist, wird die 
PICT-Datei eingelesen und der Image-Eigenschaft des ImageWells zugewiesen. 


Wenn Sie das gedroppte Objekt der BackDrop-Eigenschaft eines Canvas-Steuerelements zuweisen wollen, ist der Drop- 
Object-Handler praktisch identisch: 
If Obj.PictureAvailable then 

Canvasl.Backdrop=0bj.Picture 
Elseif Obj.FolderItemAvailable then 

Canvasl.Backdrop=0bj.FolderItem.OpenAsPicture 
End if 
Sie konnen auch ein Text-Objekt auf ein Canvas-Steuerelement draggen und die DrawString-Methode der Gra- 
phics-Klasse verwenden, um den Text zu zeichnen. Um das Draggen zu erlauben, verwenden Sie folgende Zeile in einem 
Event-Handler, der vor dem Drag & Drop des Anwenders aufgerufen werden muss: 


me.AcceptTextDrop 
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Als nachstes tiberpriifen Sie im DropObject-Event-Handler das Objekt auf Text. Folgender Code akzeptiert gedraggten 
Text und schreibt diesen an die angegebene Stelle: 

If Obj.TextAvailable then 

Canvasl.Graphics.DrawString(obj.text,20,20,50) 
End if 
Sie werden die Daten durch Verwenden des Paint-Event-Handler aktualisieren miissen, wenn Sie méchten, dass die 
Daten von Dauer sind. 


MacData und PrivateMacData Eigenschaften 


Die MacData und PrivateMacData-Eigenschaften erlauben Drag&Drop von anderen Datentypen. Jede Eigenschaft ver- 
wendet einen vierbuchstabigen Type, der dem vierbuchstabigen Resource-Code des Formats der Daten entspricht, die 
Sie Draggen mGchten. Wenn Sie z.B. das Dragging von Sound-Clips unterstiitzen wollen, miissten Sie als vierbuchstabi- 
gen Code ,,snd “ verwenden. 


Unabhingig vom Format werden die Daten im Dragltem als String gespeichert und der DropObject-Event-Handler 
wiirde diese Daten einer Eigenschaft tibergeben, die einen String erwartet. Das Steuerelement oder Fenster, das das 
Dragltem empfangt, muss in der Lage sein, mit diesem Format umzugehen. In den meisten dieser Falle handelt es sich 
um benutzerdefinierte Steuerelemente, die Toolbox-Aufrufe und ein Plugin verwenden, das die Daten verarbeitet. 


Um dem Anwender das Dropping einer ,,snd “-Resource auf ein Steuerelement zu erlauben, miissten Sie folgendes in 
den Open-Event-Handler des Steuerelements schreiben: 


acceptMacDataDrop("snd ") 

Der DropObject-Event-Handler wiirde die tibergebenen Daten an eine Eigenschaft tibergeben, die einen String spei- 
chert. Um den Sound abzuspielen, miisste das Steuerelement Toolbox-Aufrufe ausfiihren oder die Daten einem Plugin 
tibergeben, da REALbasic keine Moglichkeit bietet, Sound-Daten an eine Sound-Klasse zu tibergeben. 


Sie konnen MacData oder PrivateMacData auch verwenden, um internes Drag&Drop zu realisieren. Wenn Sie einen For- 
mat-Typ verwenden, der sich vom Namen von jedem Resource-Typ unterscheidet, konnen Sie steuern, welche Objekte 
auf ein Steuerelement gedroppt werden diirfen. Z.B. verwendet der DragRow-Event-Handler einer ListBox den Typ 
»mytp“, um das Format zu definieren: 


Function DragRow(drag as DragItem, row as Integer) as Boolean 

Drag.MacData("mytp" )=me.List(row) 

Return True 

End Function 

Das Dragltem wird der Zeile in der ListBox zugewiesen, in die es gedraggt wurde. Obwohl die Zeile ein normaler String 
ist, kann dieses Dragltem nicht auf ein Steuerelement gedroppt werden, so lange dieses nicht Daten des Typs ,.mytp“ 
akzeptiert. Auf diese Weise k6nnen Sie z.B. ein Steuerelement erzeugen, das nur Dragltems eines bestimmten Typs 
akzeptiert und gedragete Objekte aus dem Finder, anderen Programmen oder anderen Steuerelementen abweist. 


Die ListBox, die die Daten erhilt, wiirde folgenden Befehl verwenden, um das Dropping der Daten zu erlauben: 
me.AcceptMacDataDrop("mytp" ) 
Der DropObject-Event-Handler weist die Daten einer neuen Zeile zu: 


f obj.MacDataAvailable("mytp") then 
me.AddRow(obj.MacData("mytp" )) 
end 


Die PrivateMacData-Eigenschaft arbeitet in der gleichen Art, auSer dass das DragItem nicht vom Schreibtisch oder einer 
anderen Anwendung kommen kann. 


MacData und PrivateMacData sind nur in Macintosh-Applikationen verftigbar. 
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Meniis und Meniipunkte 


Meniis und Meniipunkte werden dhnlich wie Steuerelemente behandelt und sind genauso objektorientiert. Dies bedeu- 
tet, dass Meniis vom Application-Objekt, von Fenstern oder von Steuerelementen beeinflusst werden kénnen. Beim 
Erstellen eines neuen Projekts legt REALbasic automatisch ein Menubar-Objekt namens MenuBarl an. Dabei handelt es 
sich um die voreingestellte globale Meniileiste ftir die gesamte Anwendung. 


Sie konnen Ihrem Projekt weitere Meniileisten hinzuftigen und Meniileisten bestimmten Fenstern zuordnen. Unter Win- 
dows und Linux ist die Meniileiste einem Fenster fest zugeordnet und tritt immer mit dem entsprechenden Fenster in 
Erscheinung. Auf dem Mac wird beim Aktivieren eines Fensters die aktuelle Meniileiste durch die des Fensters ersetzt. 


Selektiert der Benutzer einen Mentipunkt oder driickt er dessen zugeordnetes Tastenktirzel, dann wird ein Event ausge- 
lost, genau als ob er einen PushButton gedriickt hatte. Bei Mentis heifSt der Event-Handler Menu-Handler. 


Code fiir einen Meniipunkt 
Ein Menu-Handler wird so eingegeben: 
1. Offnen Sie den Code-Editor fiir dieses Fenster oder die Klasse. 
2. Wahlen Sie Bearbeiten/Neuer Menu-Handler. 
Die Dialogbox ,,Neuer Menu-Handler« erscheint. 
3. Wahlen Sie einen Mentipunkt aus dem Popup-Menii mit den Mentipunkten. 
Existiert der Meniieintrag nicht, da er dynamisch erzeugt wird, tragen Sie dessen Bezeichnung ein. 
4. Klicken Sie OK. 
Der Code-Editor erscheint mit ausgewahltem Menu-Handler. 


5. Geben sie den Code ein, der ausgefiihrt werden soll, wenn dieser Mentipunkt aufgerufen wird. 


Abb. 190: Die Dialogbox ,,Neuer Menu-Handler” 
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Meniipunkte aktivieren 


Jeder Meniipunkt besitzt eine Autoenable-Eigenschaft, die den Wert TRUE oder FALSE annehmen kann. Steht diese 
Eigenschaft auf TRUE, bleibt der Mentipunkt aktiviert, bis Sie ihn explizit deaktivieren. Autoenable kGnnen Sie im Eigen- 
schaftenfenster setzen. 

(o) Eigenschaften 


Name: AllesMarkieren 
Index: 
Super: Menultem v 


Text: Alles markieren... Q 

Bold: () 

Italic: 2 

Underline: 2) 
BalloonHelp: 
DisabledBalloonH... 


oo 


CommandKey: 
SubMenu: 2) 
AutoEnable: 
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Der voreingestellte Wert ist TRUE. Solange Sie die Autoenable-Eigenschaft nicht deaktivieren, wird der Mentipunkt auto- 
matisch aktiviert. Sie sollten die Autoenable-Eigenschaft fiir Mentipunkte benutzen, die standig aktiv sein sollen. Dabei 
k6nnte es sich z.B. um einen Meniibefehl handeln, der ein neues Dokument erzeugt oder bestehendes offnet. 


Wenn Sie die Autoenable-Eigenschaft abschalten, ist der Meniieintrag per Voreinstellung inaktiv. Sie haben nun die Ver- 
antwortung, den Mentipunkt immer dann zu aktivieren, wenn die Umstinde es erfordern. Dies erreichen Sie tiber das 
EnableMenultems-Event. Es bietet sich an, die Autoenable-Eigenschaft auszuschalten und das EnableMenultem einzu- 
setzen, falls ein Mentipunkt nur unter ganz bestimmten Bedingungen aktiviert werden soll. Wenn beispielsweise ein 
,Save“-Meniipunkt nur dann aktiv sein soll, wenn der Benutzer seit dem letzten Speichervorgang Anderungen an seinem 
Dokument vorgenommen hat, dann wiirden Sie zu diesem Zweck das EnableMenultems-Event einsetzen, um zu bestim- 
men, wann der Mentipunkt aktiviert oder deaktiviert werden soll. 


Klickt der Benutzer auf ein Menii, um daraus einen Mentipunkt auszusuchen, wird ein EnableMenultems-Event ausge- 
Ost. Dies gibt Ihnen die Gelegenheit zu entscheiden, ob die Mentipunkte im gewahlten Menii in der gegenwartigen Situ- 
ation selektierbar sein sollen oder nicht. REALbasic tiberpriift zuerst, ob das Steuerelement, das gerade den Fokus hat, 
eine Mentibehandlung vornehmen kann. Ist dies der Fall, wird dort ein EnableMenultems-Event ausgeldst. Dann 
ekommt das oberste gedffnete Fenster ein solches Event (vorausgesetzt ein Fenster ist gedffnet) und am Schluss wird 
es an das Application-Objekt geschickt. 


Mentipunkte sind Objekte wie Steuerelemente auch. Daher besitzen Sie die Eigenschaft Enabled, die anzeigt, ob der 
Mentipunkt gerade gewahlt werden kann oder nicht. Der folgende EnableMenultems-Event-Handler priift z.B. eine 
Eigenschaft ,,Geandert“, um zu entscheiden, ob der Mentipunkt Sichern aktiviert sein soll: 
Sub EnableMenultems () 

If Me.Gedndert Then 

AblageSichern. Enabled=True 


End If 
End Sub 


Behandeln der Meniipunkte mit Steuerelementen 


Hat ein Steuerelement den Fokus und ist in der Lage, Mentipunkte zu verarbeiten, dann wird sein EnableMenul- 
tems-Event-Handler ausgefiihrt. Ist ein Mentipunkt selektierbar und wird vom Benutzer angewahlt, dann wird der 
Menu-Handler des Steuerelements fiir den gewahlten Meniipunkt aufgerufen, sofern das Steuerelement einen solchen 
Menu-Handler hat. Damit ein Steuerelement Meniipunkte verarbeiten kann, muss es den Fokus erhalten konnen (auf 
einem Macintosh muss es ein EditField, ListBox, ComboBox oder Canvas sein) und es muss auf einer Klasse aufsetzen, 
die Sie selbst definiert und im Projekt angelegt haben. Es ist nicht bei Steuerelementen mdglich, die Sie aus der Steuere- 
lementepalette auf das Fenster gezogen haben. Mehr Informationen dariiber finden Sie im Kapitel \Wiederverwendbare 
Objekte durch Klassen“ auf Seite 304. 


Behandeln der Menipunkte, wenn ein Fenster gedffnet ist 

Sie wissen bereits, dass der EnableMenultems-Event-Handler des obersten Fensters aufgerufen wird, wenn der Benutzer 
einen Mentipunkt selektieren will, bevor der EnableMenultems-Event-Handler des Application-Objekts aufgerufen wird. 
Dies gibt Ihnen die Gelegenheit, zunachst zu ermitteln, ob die Bedingungen ftir das oberste Fenster dazu fiihren sollten, 
um bestimmte Mentipunkte zuganglich zu machen. 


Behandeln von Meniipunkten, wenn keine Fenster offen sind 


Sind keine Fenster offen, wird das EnableMenultems-Event an das Application-Objekt geschickt. Wird ein Mentipunkt 
ausgewahlt, dann wird der Menu-Handler im Application-Objekt aufgerufen, sofern ein passender definiert ist. 

Beim Anlegen eines neuen Projekts wird immer eine auf dem Application-Objekt beruhende Klasse dem Projekt hinzu- 
gefiigt. Diese Klasse nennt sich App-Klasse. 
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Abb. 191: Die App-Klasse im Projektfenster eines Standard-Projekts 
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Fiir den Fall, dass der Endbenutzer alle Fenster Ihrer Anwendung schlieft und sich dann dazu entschlie&t, itiber einen 
Meniipunkt ein neues Fenster zu erzeugen, miissen Sie diesen Mentipunkt im Application-Objekt aktivieren, da Ihnen 
zu diesem Zeitpunkt keine Fenster zur Verfiigung stehen, um den Mentipunkt zu aktivieren und die Mentiauswahl zu 
verarbeiten (vorausgesetzt Sie verzichten auf die AutoEnable-Eigenschaft des Mentipunktes). Offnen Sie dazu im Pro- 
jektfenster den Code-Editor der App-Klasse, klappen Sie die Events aus und wahlen Sie das EnableMenultems-Event. 


Neue Meniipunkte dynamisch erzeugen 


Dies funktioniert so ahnlich wie die dynamische Erzeugung von Steuerelementen. Ein Mentipunkt, der als Vorlage die- 
nen kann, muss bereits existieren. Dieser wird dann kopiert. Sie konnen die Eigenschaften der Kopie dann dndern (zum 
Beispiel den Text, der im Meniti stehen soll). Meniipunkte miissen immer einen Indexwert in der Index-Eigenschaft 
haben, um als Vorlage benutzt werden zu k6nnen. Weisen Sie der Index-Eigenschaft dieses Vorlagementipunkts eine 0 
zu, um ein Array mit Mentipunkten zu erzeugen. Die Menu-Handler bekommen dann einen Indexwert, der Ihnen jeweils 
erlaubt festzustellen, welcher Meniipunkt angeklickt wurde. Ohne den Indexwert k6nnen Sie das nicht. Kopien der Vor- 
lage k6nnen Sie mit dem New-Operator erzeugen. Im Beispiel wird ein neuer Meniipunkt angelegt, der aus der Vorlage 
Windowltem*“ hervorgeht: 

Dim t as Menultem 

t=New WindowItem 

Denken Sie daran, dass Sie nach dem Erzeugen des Arrays mit den Mentipunkten die einzelnen Elemente wie bei einem 
normalen Array ansprechen. Um den ersten Mentipunkt zum Beispiel selektierbar zu machen (dies ist Element 0 aus 
dem Beispiel mit Windowltem) gehen Sie so vor: 

WindowItem(0).Enabled=True 


Wenn Sie programmgesteuert Mentipunkte entfernen méchten, die Sie zuvor erzeugt haben, miissen Sie sich die Refe- 
renz auf den Meniipunkt merken, die Sie erhalten, wenn der Meniipunkt erzeugt wird. Mit der Close-Methode und die- 
sem Parameter kann der Mentipunkt dann entfernt werden. Wenn Sie die Referenzen im obigen Beispiel in einem Array 
namens WindowRefs gespeichert haben, dann kGnnen Sie ein bestimmtes Element entfernen, indem Sie beispielsweise 
so vorgehen: 


WindowRefs(4).Close 


Klassen 


Klassen konnen verwendet werden, um benutzerdefinierte Steuerelemente zu entwerfen, die auch auf Benutzereinga- 
ben reagieren kénnen. Mehr dazu finden Sie im Abschnitt ,,Anlegen selbstdefinierter Steuerelemente mit Klassen“ auf 
Seite 322. 
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kites Globale Funktionen durch Module 


Objektorientierte Programmierung ist sehr effizient, aber manchmal werden Sie Methoden, Funktionen oder Eigen- 
schaften benotigen, die nicht an ein Objekt gebunden sind. Dies kénnte zum Beispiel eine finanzmathematische Berech- 
nung sein, die an verschiedenen Stellen des Programms benotigt wird. Dazu miissen Sie dann vielleicht noch Werte 
speichern, die ftir diese Funktion ben6tigt wird. In den meisten dieser Falle ist ein Modul daftir am besten geeignet. 


Konstanten kénnen zwei spezielle Zwecke haben, wenn man Sie Modulen hinzuftigt. Sie konnen verwendet werden, um 
die Interface-Elemente einer Applikation zu lokalisieren und um Windows-Shortcuts anzubieten. 


Inhalt 


© Was sind Module? 

@ Einftigen von Methoden in ein Modul 

@ Einftigen von Konstanten in ein Modul 

e Einftigen von Eigenschaften in ein Modul 


Was sind Module? 


In der objektorientierten Umgebung von REALbasic sind geschiitzte Methoden, Konstanten und Eigenschaften norma- 
lerweise Teile von Objekten. Sie sind nur tiber diese Objekte erreichbar. 


Module sind keine Objekte und besitzen auch keine tibergeordnete Klasse. Sie werden nie mit dem New-Befehl als 
Instanz im Speicher angelegt. Nachdem Sie ein Modul in Ihrem Projekt angelegt haben, sind seine Methoden, Konstan- 
ten und Eigenschaften sofort verftigbar. Die einzige Ausnahme bilden private Methoden, Eigenschaften oder Konstan- 
ten, die zu diesem Modul gehdren. Als privat deklarierte Teile eines Moduls, k6nnen nur innerhalb des Moduls 
angesprochen werden. 


Anlegen eines neuen Moduls 


Ein neues Modul erzeugen Sie, indem Sie den Menitieintrag Ablage/Neues Modul auswahlen. Sie konnen aber auch das 
Kontextmenti im Projektfenster verwenden und dort den Meniipunkt Neu/Neues Modul wahlen. 


@ © OScreenshotProjekt... 


= r 
is Fenster bearbeiten 
iq Code bearbeiten 


Verschisseln... 
Fenster exportieren... 
Extern machen 


Neu > Neues Fenster 
CT = Neue Klasse 
Neues Klassen-Interface 
——— Neues Modul 


Neuer Ordner 
Neuer MenuBar 
—————— ESE! 
Das neue Modul erscheint in Ihrem Projektfenster und erhilt einen vorgegebenen Namen (das erste heift ,Module1“). 
Sie konnen ihm einen eigenen Namen geben, indem Sie diesen im Eigenschaftenfenster eingeben. Fiir finanzmathema- 
tische Funktionen bietet sich zum Beispiel ,,Financial“ an. 
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Module kénnen nur Methoden, Konstanten und Eigenschaften enthalten. Diese konnen nur im Code-Editor verindert 
werden. Um den Code-Editor zu einem Modul zu 6ffnen, miissen Sie einen Doppelklick auf dem Modul im Projektfens- 
ter ausfthren. Module sind an ihrem Piktogramm in diesem Fenster sofort zu erkennen. 


Abb. 192: Ein Modul im Projektfenster 
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Giltigkeitsbereich von Methoden, Eigenschaften und 
Konstanten eines Moduls 


Global: Globale Methoden, Eigenschaften oder Konstanten konnen innerhalb des gesamten Projekts verwendet wer- 
den. Der globale Giiltigkeitsbereich ist nur fiir Elemente eines Moduls verfiigbar. Sie konnen beispielsweise eine globale 
Eigenschaft als eine Information betrachten, die in allen Teilen Ihres Projekts verfiigbar ist. Sie greifen auf eine globale 
Methode, Eigenschaft oder Konstante tiber ihren Namen zu. 


Offentlich: Eine 6ffentliche Konstante, Eigenschaft oder Methode ist ebenfalls in allen Teilen eines Projekts verfiigbar. 
Allerdings miissen Sie tiber Punkt-Notation darauf zugreifen. Wenn Sie eine 6ffentliche Eigenschaft ,,meineEigenschaft* 
im Modul ,,Modul1“ erzeugen, konnen Sie diese tiber ,Modul1.meineEigenschaft“ erreichen. Innerhalb von Modul1 k6n- 
nen Sie die Eigenschaft einfach tiber die Bezeichnung verwenden. 


Privat: Private Konstanten, Methoden oder Eigenschaften sind nur innerhalb des Moduls verftigbar, in dem sie dekla- 
riert wurden. Alle anderen Teile eines Projekts konnen nicht darauf zugreifen. 


Einfigen von Methoden in ein Modul 


Methoden werden in ein neues Modul genauso eingefiigt, wie Sie es bei einem Fenster machen wiirden: 
Zum Einftigen einer Methode: 


1. Wenn der Code-Editor fiir das Modul nicht bereits ge6ffnet ist, fiihren Sie einen Doppelklick auf das Modul im Pro- 
jektfenster aus, um ihn zu 6ffnen oder driicken Sie alt-Tab. 


2. Wahlen Sie Bearbeiten/Neue Methode. Die Dialogbox zur Deklaration einer Methode erscheint. 


Abb. 193: Das Sheet-Fenster fiir die Methoden-Deklaration 
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3. Geben Sie den Namen und die Parameter der Methode ein. 
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Wenn Sie Parameter angeben, bestimmen Sie den Datentyp jedes einzelnen Parameters. Wenn Sie beispielsweise eine 
FlieSkommazahl tibergeben wollen, die innerhalb der Methode tiber die Bezeichnung ,,X“ erreichbar ist, so geben Sie 
folgenden Parameter an: 
X As Double 
Wenn Sie mehrere Parameter angeben wollen, trennen Sie diese mit einem Komma. Um ein Array zu tibergeben, 
fiigen Sie der Bezeichnung leere Klammern an. In unserem Beispiel von eben ware das: 
X() As Double 

4. Soll die Methode eine Funktion sein, wahlen Sie einen Datentyp fiir den Rtickgabewert. Sie konnen Arrays oder ein- 
zelne Werte zuriickgeben. Fiir ein Array fiigen Sie leere Klammern an den Datentyp. Fiir ein Integer-Array ware dies: 
Integer() 

5. Wahlen Sie den Giiltigkeitsbereich der Methode. 

6. Klicken Sie auf OK. 


Der Code-Editor fiir das Modul erscheint und zeigt die neu angelegte Methode an. Wenn der Giiltigkeitsbereich 
Privat ist, heifst der Sub-Ausdruck ,,Private Sub...“, andernfalls nur ,,Sub...“. 


Klassenerweiterungsmethoden 


Eine Klassenerweiterungsmethode wird mit einer Syntax aufgerufen, die bereits andeutet, dass die Methode zu einem 
anderen Objekt gehért. Zum Beispiel konnen Sie eine Methode schreiben, die von einem Folderltem-Objekt aufgerufen 
werden kann. 

Um eine Methode als Klassenerweiterungsmethode zu definieren, benutzen Sie das Schliisselwort Extends“ vor dem 
ersten Parameter. Der Datentyp des ersten Parameters ist der Datentyp der Objekte, aus denen die Methode aufgerufen 
werden darf. Ein Beispiel: 

Sub meineMethode(Extends f As FolderItem, Name As String) 

Wird aufgerufen mit: 


Dim f As FolderItem 
f .meineMethode(“Test”) 


Abb. 194: Deklarieren einer Klassenerweiterungsmethode fiir die Folderltem-Klasse. 
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Das Extends-Schliisselwort kann nur fiir Methoden eines Moduls verwendet werden. 


Einfligen von Eigenschaften in ein Modul 


Modul-Eigenschaften werden wie Fenster-Eigenschaften zu einem Projekt hinzugefiigt. Bestimmen Sie den Giiltigkeits- 
bereich der Eigenschaft, um festzulegen, welche Teile Ihres Projekts darauf zugreifen konnen. 
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Zum Einfligen einer Eigenschaft: 
1. Offnen Sie das Modul mit einem Doppelklick im Projektfenster. Der Code-Editor fiir dieses Modul erscheint. 
2. Wahlen Sie Bearbeiten/Neue Eigenschaft. 


Abb. 195: Die Dialogbox fiir die Eigenschaft-Deklaration 
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3. Geben Sie der Eigenschaft einen Namen und einen Datentyp. Wollen Sie beispielsweise einen Namen speichern, 
dann geben Sie Name As String ein. 


Die Eigenschaft kann auch ein Array sein. Méchten Sie ein String-Array mit vier Elementen deklarieren, das Vorname, 
Nachname, Adresse und Telefonnummer speichert, so schreiben Sie: 


aNamen(3) As String 
Sie miissen die Grd&e des Arrays angeben, kénnen diese aber spater im Code mit der Redim-Methode verandern. 
4, Wahlen Sie einen Giiltigkeitsbereich aus und lassen Sie sich die Eigenschaft — falls gewiinscht — im Eigenschaftenfen- 
ster anzeigen. 
Ist eine Eigenschaft privat, wird ihr Icon im Code-Editor mit einem Warndreieck angezeigt. 
5. Klicken Sie OK, um die Eigenschaft zu speichern. 
Wenn Sie OK klicken, erscheint die Eigenschaft in der Gruppe der Eigenschaften. Der Code-Editor zeigt die Deklara- 
tion der neuen Eigenschaft an. 
6. Jetzt konnen Sie noch Notizen und Kommentare zu der Eigenschaft eingeben. 
Wenn Sie ein Modul nur anlegen wollen, um globale Eigenschaften unterzubringen, sollten Sie in Erwagung ziehen, 
diese statt dessen in der App-Klasse zu deklarieren. Die App-Klasse wird automatisch zusammen mit Ihrem Projekt ange- 
legt. Sie haben damit auch globale Eigenschaften zur Verftigung, die aber direkt mit dem Projekt verbunden sind und 
nicht in einem Modul ausgegliedert sind, das zufallig eben Bestandteil des Projektes ist. Mehr Informationen dazu finden 
Sie im Abschnitt ,,Die Application-Klasse“ auf Seite 320. 


Einfligen von Konstanten in ein Modul 


Globale Konstanten kdnnen keine nicht druckbaren Zeichen wie Return, Tab, Space usw. enthalten. Eine Moglichkeit, 
ein globales Objekt zu erzeugen, das ein solches Zeichen enthilt, besteht darin, einem Modul eine Funktion hinzuzufii- 
gen, die das gewiinschte Zeichen ausgibt. Um z.B. ein Objekt zu erzeugen, dass ein Carriage Return-Zeichen (ASCII 13) 
ausgibt, fiigen Sie Ihrem Modul folgende Funktion hinzu: 

Function CR as String 

Return Chr(13) 

End Function 

Eine Konstante einem Modul hinzufiigen 

Um in einem Modul eine Konstante anzulegen, gehen Sie folgendermafsen vor: 


1. Klicken Sie im Projektfenster doppelt auf das Modul, um es im Code-Editor zu 6ffnen. 
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2. Rufen Sie Bearbeiten/Neue Konstante auf. 


Abbildung 196. Der Dialog ,,Neue Konstante’: 
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3. Geben Sie der Konstanten einen Namen, legen sie ihren Datentyp, Giiltigkeitsbereich und ihren Wert fest. 


Méchten Sie einen mehrzeiligen Text eingeben, klicken Sie auf den kleinen Button, neben dem Wert-Editfield. Dar- 
aufhin erscheint folgender Dialog, in dem Sie mehrzeiligen Text eingeben k6nnen. 


Wert bearbeiten 


(Abbrechen) XD 


4. Klicken Sie auf OK. 
Die Dialogbox ,,Neue Konstante“ unterstiitzt Standard-Cut/Copy/Paste-Operationen. 


Wenn Sie die ,,Neue Konstante“-Dialogbox bestitigen, erscheint die Konstante in der Objektliste des Moduls. Der Wert 
der Konstanten wird neben einem Icon, das auf seinen Datentyp hinweist, angezeigt. Folgende Abbildung zeigt den 
Code-Editor eines Moduls, nachdem mehrere Konstanten hinzugeftigt wurden. 


Abb. 197: Der Code-Editor eines Moduls mit Konstanten aller méglichen Datentypen 
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Farbkonstanten 
Sie konnen Konstanten vom Typ Color erzeugen. Farbkonstanten stellen sicher, dass Ihre Applikation einheitliche Far- 


ben verwendet. Wenn Sie eine Farbkonstante erzeugen, bestimmen Sie deren RGB-Wert (Rot, Griin, Blau). Sie legen den 
Wert jeder Komponente mit folgenden Format fest: 


&CRRGGBB 
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Dabei ist RR der Rotanteil, GG der Griinanteil und BB der Blauanteil. Der Neue Konstante“-Dialog macht die Auswahl 
der Farbe sehr einfach, da er einen Colorpicker enthilt, der erscheint, wenn Sie den Typ Color auswahlen. Wenn Sie mit 
dem Colorpicker eine Farbe auswahlen, wird diese beim Schliefsen automatisch tibernommen und als Wert eingetragen. 
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Lokalisieren mit Konstanten 

Globale Konstanten bieten einen bequemen Weg, eine Applikation zu lokalisieren. Wenn Sie globale Konstanten ftir die 
Texte in Ihrer Applikation verwenden, k6nnen Sie Ihre Applikation lokalisieren, indem Sie die Standardsprache in den 
Projekteinstellungen dndern und die Sprache in den Compiler-Einstellungen, bevor Sie die Applikation compilieren. 
Weitere Informationen finden Sie im Abschnitt ,.Das Programm erzeugen“ auf Seite 388. 

Der Lokalisierungstabelle im unteren Bereich der Dialogbox ,.Neue Konstante“, erlaubt es, der Konstanten abhangig von 
der Plattform und der Sprache verschiedene Werte zuzuweisen. Wenn Sie im Projekt-Einstellungen- oder im Applikation 
erzeugen-Dialog die Sprache dndern, werden fiir die verschiedenen Konstanten automatisch die entsprechenden Werte 
eingesetzt. Sie miissen nur Werte fiir die verschiedenen Sprach- und Plattform-Kombinationen bestimmen. 

Sie konnen unter folgenden Plattformen wahlen: 


Windows 

Macintosh: jedes Mac OS, auf dem REALbasic lauffahig ist 

Linux 

Macintosh (Classic): jede Mac OS Classic Version, auf der REALbasic lauffhig ist 

Macintosh (Carbon): PEF Format; lauft unter klassischen Mac OS mit CarbonLib und unter Mac OS X 
Macintosh: Mach-O-Format, lduft nur unter Mac OS X 


Diese Auswahl erlaubt es Ihnen, fiir die verschiedenen Betriebssysteme unterschiedliche Definitionen Ihrer Konstanten 
vorzunehmen. Im Folgenden wird gezeigt, wie man die Beschriftung eines Buttons lokalisiert, der zum Abbrechen einer 
Aktion verwendet wird. 


Um eine Konstante zu vereinbaren, die den Caption-Text eines Buttons enthalt, gehen Sie folgendermafsen vor: 
1. Rufen Sie Bearbeiten/Neue Konstante auf und legen Sie eine neue Konstante an. 

2. Geben Sie einen Wert fiir die Standardsprache ein und setzen Sie den Typ auf String. 

3. Wahlen Sie einen Giiltigkeitsbereich fiir die Konstante 


Ublicherweise sind Konstanten fiir die Lokalisierung global verfiigbar, wenn Sie in Meniis oder Steuerelementen ver- 
wendet werden. 


4. Klicken Sie auf Hinzuftigen im unteren Bereich. 


REALbasic fiigt eine leere Zeile in die Tabelle ein, wie in folgender Abbildung gezeigt. 


Einfiigen von Konstanten in ein Modul 235 


Abb. 198: Lokalisieren des Abbrechen-Knopfes fiir die deutsche Version 
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Die Plattformspalte legt die Betriebssystemplattform fest, fiir die die Konstante verwendet werden soll. In der Sprach- 
spalte konnen Sie neben der aktuellen Systemsprache jede beliebige Sprache auswahlen. 
5. Wahlen Sie die gewiinschte Kombination aus Plattform und Sprache und bestimmen Sie einen Wert. 
6. Wiederholen Sie Schritt 5 fiir jede weitere Kombination, die Sie benotigen. 
7. Speichern Sie die Konstante, indem Sie auf OK klicken. 
Es ist zwingend notig, dass ftir jede Plattform/Sprache-Kombination, die Sie anbieten wollen, ein Wert gesetzt wird. 


Auch Menitis und Meniieintrage konnen so lokalisiert werden. Vereinbaren Sie fiir jeden Text, der als Menti oder Menii- 
eintrag verwendet wird, eine globale Konstante. In die Text-Eigenschaft des Meniis tragen Sie dann den Namen der ent- 
sprechenden Konstanten mit vorangestelltem Nummernzeichen (,#*) ein. 

Die folgende Abbildung zeigt ein lokalisiertes Menii. 


Abb. 199: Lokalisieren eines Meniis und eines Meniipunkts 
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Meniipunkt 
Diese Technik kann fiir alle statischen Texte verwendet werden, die in Fenstern erscheinen: BevelButton-Meniis, Kon- 


textmentis, Karteireiterbeschriftungen etc. Sie konnen auf die Konstante verweisen, indem Sie ihren Namen im Eigen- 
schaftenfenster eingeben und ein Nummerzeichen (#) davor setzen. 


Sie konnen Konstanten auch in den Eingabefeldern der Compiler-Einstellungen verwenden, in die Sie statischen Text 
eingeben k6nnen. 
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REALglot zum Lokalisieren der Applikation einsetzen 


Auf der REALbasic CD befindet sich ein Dienstprogramm namens REALglot, mit dem es sehr komfortabel moglich ist, 
alle notigen Konstanten ftir eine Lokalisierung hinzuzuftigen. 

REALglot durchsucht Ihr Programm und tiberpriift, ob Sie Konstanten fiir alle Interface-Elemente verwendet haben und 
erlaubt Ihnen dann, diese Konstanten zu bearbeiten. 


REALglot verwendet die Ausdriicke Source Language fiir die Ausgangssprache und Target Language (Zielsprache) ftir 
die Sprache, in die das Programm tibersetzt werden wird. Die Ausgangssprache ist normalerweise die Sprache, fiir die 
Sie Ihr Programm schreiben. Das ist die Sprache, die Sie fiir die Beschriftung der Kndpfe, der Menitieintrdge usw. ver- 
wenden. Derjenige, der Ihr Programm lokalisiert, wird diese Sprache als Referenz verwenden, da alle Ihre Konstanten in 
der Ausgangssprache Werte haben werden. 

Die Vorgehensweise ist folgende: 


Suchen Sie mit REALglot alle Interface-Elemente, die keine Konstanten verwenden. 

Fiigen Sie dem Programm, wo notig, Konstanten hinzu. 

Erzeugen Sie fiir die Ausgangssprache Instanzen aller Konstanten. 

Wahlen Sie die Zielsprache(n) aus und fiigen Sie Instanzen jeder Konstante fiir jede Zielsprache hinzu. 

Exportieren Sie eine Liste der Interface-Elemente als Tabulator-getrennte Text-Datei fiir jede Zielsprache. Diese Liste 
enthalt eine Zeile fiir jedes Interface-Element mit Spalten fiir Plattform, Ausgangssprache und Zielsprache. Die Spalte 
fiir die Ausgangssprache ist ausgefiillt, die Spalte fiir die Zielsprache ist jedoch leer. Diese Datei senden Sie an den 
Ubersetzer. Der Ubersetzer fiigt die korrekten Ausdriicke in die Spalte fiir die Zielsprache ein und schickt Ihnen die 
vervollstindigte Datei zuriick. 

© Sie importieren dann die vervollstandigte Textdatei in REALglot und gleichen sie mit Ihrem Projekt ab. Wenn Sie es 
danach in REALbasic 6ffnen, ist das Projekt ftir die Zielsprache lokalisiert. 


REALglot ladt nur Projekte, die im XML-Format gespeichert sind. Es gibt jedoch eine Voreinstellung, bei der Sie ein 
REALbasic-Programm auswahlen kénnen, das dazu verwendet wird, das Projekt ins XML-Format zu konvertieren. 
Wenn diese Voreinstellung selektiert ist, konnen Sie ein beliebiges REALbasic-Projekt 6ffnen und REALbasic speichert 
dieses fiir Sie zuerst im XML-Format. 


So lokalisieren Sie Ihr Projekt mit REALglot: 


1. Speichern Sie eine Kopie Ihres REALbasic-Projektes im XML-Format. Dies machen Sie, indem Sie ,,Ablage/Sichern als“ 
anwahlen, im ,,Format“-Popup ,,XML‘ auswahlen und dann auf ,,Sichern“ klicken. 


2. Starten Sie REALglot und 6ffnen Sie die eben erzeugt XML-Datei. 
Wenn Sie die XML-Datei das erste mal 6ffnen, durchsucht REALglot Ihr Projekt nach doppelten Konstanten. Wenn 
solche gefunden werden, erhalten Sie einen Dialog, der eine Liste dieser Elemente enthalt. Sie sollten Konstanten, 
die einen doppelten Namen enthalten, umbenennen, damit Sie sicher sein konnen, dass Ihr Programm sich wie 
gewtinscht verhilt. 
Danach 6ffnet sich eine Dialogbox, die alle Interface-Objekte auflistet, denen keine Konstanten zugewiesen wurden. 
Dies zeigt folgende Abbildung: 
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Sie sollten ftir alle Interface-Elemente Konstanten verwenden, damit Sie die Applikation komplett lokalisieren k6n- 
nen. 


3. Falls nétig, wahlen Sie die Interface-Elemente in der Liste aus, ftir die Sie Konstanten erzeugen mochten und klicken 
dann auf Create. 
Thr XML-Projekt wird in einem Fenster angezeigt. 
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Das Language-Popup-Menii enthilt eine Liste aller unterstiitzten Sprachen. Als erstes sollten Sie Instanzen fiir die 
Ausgangssprache erzeugen. 


4, Wahlen Sie die Ausgangssprache im Language-Popup-Menii aus und markieren Sie alle Interface-Elemente, die keine 
Konstanten besitzen. 
Nun wird der Make-Knopf anwahlbar. 


5. Klicken Sie auf den Make-Knopf, um Konstanten fiir die Ausgangssprache zu erzeugen. 
Als nachstes miissen Sie Konstanten fiir alle ben6tigten Zielsprachen hinzuftigen. 

6. Selektieren Sie eine Zielsprache aus dem Language-Popup-Menii und markieren Sie alle Interface-Elemente, die noch 
keine Konstanten besitzen und klicken Sie dann auf Make. 


7. Wiederholen Sie diesen Schritt fiir alle benotigten Zielsprachen. 
Wenn Sie damit fertig sind, konnen Sie die Textdateien exportieren. Sie miissen so viele Textdateien wie Zielsprachen 
erzeugen. 


8. Um die Konstanten und ihre Werte zu exportieren, wahlen Sie den Mentipunkt File/Export Constants an. Es 
erscheint die Dialogbox Export Languages. 


Export Languages B 
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Sie miissen die Ausgangs- und die Zielsprache auswahlen. Die Zielsprache (Target) ist die, fiir die Sie die Lokalisie- 
rung durchfiihren méchten. 


Wahlen Sie Source und Target aus und klicken Sie auf Export. 
Wenn jemand anderes ftir Sie die Lokalisierung Ihres Projektes tibernimmt, k6nnen Sie diesem die exportierte Datei 
schicken. Diese durch Tabs getrennte Textdatei kann mit einem beliebigen Texteditor oder mit dem in REALglot einge- 
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bauten Konstanten-Editor bearbeitet werden. So sieht in etwa eine kleine Textdatei aus: 


Tabelle 12. Beispiel einer von REALglot erzeugten Textdatei 


Konstanten-Name Plattform English German 


ButtonCaption Any OK 

Window1_Title Any Untitled 
enu_File Any File 
enu_FileQuit Any Quit 
enu_Edit Any Edit 
enu_EditUndo Any Undo 
enu_EditCut Any Cut 
enu_EditCopy Any Copy 
enu_EditPaste Any Paste 
enu_EditClear Any Clear 


Weitere Informationen finden Sie auf der REALbasic-CD. Die exportierte Datei enthilt eine Spalte fiir den Namen der 
Konstanten, eine Spalte ftir die Plattform, eine Spalte fiir die Ausgangssprache und eine Spalte ftir die Zielsprache. Derje- 
nige, der die Applikation lokalisiert, fiillt die Spalte mit der Zielsprache ftir alle Eintrage aus, die leer sind und schickt 
Thnen danach die Datei zuriick. 
Nachdem die Lokalisierung der Konstanten erfolgt ist, wird die Datei in Ihr XML-Projekt mittels REALglot importiert. 
9. Um die Datei mit den lokalisierten Konstanten zu importieren, 6ffnen Sie zuerst die XML-Version Ihres Projektes in 
REALglot. 
10. Wahlen Sie den Mentipunkt File/Import Constants aus, um die ausgefiillte Textdatei zu importieren. 
REALglot fiigt die Werte der Zielsprache aus der Datei in die XML-Kopie Ihres Projektes ein. 
11. Speichern Sie Ihr aktualisiertes Projekt mit File/Save. 
12. Offnen Sie in REALbasic die XML-Datei. 
Sie werden bemerken, dass Sie nun lokalisierte Konstanten fiir die importierte Sprache haben. 
REALglot unterstiitzt derzeit nur Interface-Elemente. Wenn Sie in Ihrem Code Strings haben, die angezeigt werden, 
miissen Sie fiir diese selbst in REALbasic Konstanten erzeugen, damit diese ftir den Export in REALglot zur Verfiigung 
stehen. 


Importieren und exportieren von Modulen 


Module k6nnen von anderen REALbasic-Projekten importiert werden. Exportierte Module erscheinen mit einem Wiir- 
fel-Piktogramm auf dem Desktop. 


Abb. 200: Ein exportiertes Modul auf dem Desktop 


iw 
GridLock 
Module k6nnen vor dem Exportieren verschliisselt werden, um zu verhindern, dass andere Entwickler an Ihren Code 
herankommen. Wenn ein verschliisseltes Modul in ein anderes Projekt importiert wird, erscheint es im Projektfenster 


mit einem Schliissel im Icon( ify ); wenn der Entwickler darauf einen Doppelklick ausfiihrt, um den Code-Editor aufzu- 
rufen, erscheint stattdessen eine Warnbox. 
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Abb. 201: Warnbox bei verschliisseltem Modul 


! Dieses Objekt wurde vom Autor 
verschlusselt - es kann nicht 


gedffnet werden 


Der Entwickler kann das verschltisselte Modul im Projekt nutzen, er kann jedoch nicht auf den Code des Moduls zugrei- 
fen. Verschliisselung bietet eine gute Moglichkeit, eigenst’indige Module, die Erweiterungen ftir andere Programm bie- 
ten, zu verkaufen, ohne das Risiko, dass die eigene Arbeit gestohlen wird. 


Importieren 


Um ein Modul in ein Projekt zu importieren, ziehen Sie das Modul-Piktogramm einfach auf das Projektfenster. Alternativ 
konnen Sie das Modul auch iiber Ablage/Import in der Dateiauswahlbox auswahlen. Falls das Modul geschiitzt ist, 
erscheint im Projektfenster die verschlossene Version des Modul-Icons. 


Wenn Sie ein Modul unter zwei oder mehr Projekten aufteilen méchten, k6nnen Sie es als externes Projekt-Element 
importieren. Weitere Informationen finden Sie im Abschnitt ,,Externe Projektelemente“ auf Seite 309. 


Exportieren 
Module koénnen zum Gebrauch in anderen REALbasic-Projekten exportiert werden. Dazu gibt es zwei Méglichkeiten: 


e Zichen Sie das Modul aus dem Projektfenster auf den Schreibtisch. 
© Klicken Sie auf das Modul im Projektfenster und wahlen Sie Datei/Modul exportieren. 


Sie konnen beide Methoden fiir verschltisselte Module verwenden. 


Wenn Sie den Ordner, in den Sie das Modul exportieren méchten, auf dem Desktop nicht sehen konnen, ist die erste 
Methode praktischer. Wenn Sie sich zuerst zu einem bestimmten Ordner vorarbeiten miissen, ist die zweite Methode 
praktischer. Beide Methoden exportieren das Modul in seinem aktuellen Zustand — verschliisselt oder unverschliisselt. 
Verschliisselte und unverschliisselte Module haben das gleiche Desktop-Icon; der Status der Verschliisselung eines 
Moduls ist nur im Projektfenster zu erkennen. 


Module schiitzen 


Sie konnen ein Modul im Projektfenster verschliisseln (schiitzen) oder entschliisseln (den Schutz entfernen). Wenn ein 
Modul verschliisselt ist, kann niemand (einschliefslich des Autors) auf dessen Code zugreifen, ohne das Passwort 
anzugeben. 


Wenn Sie ein Modul sperren, verwenden Sie hierzu ein Passwort, das spater wieder zum Entsperren verwendet werden 
kann. In diesem Zusammenhang k6nnen Sie auch die Checkbox V3 Verschliisselung oder héher verw. aktivieren, 
wenn Sie die Riickwartskompatibilitat zu friiheren REALbasic-Versionen garantieren wollen (in REALbasic 4.5 und hoher 
konnen Sie das 2.1 Dateiformat nicht mehr verwenden). Wenn Sie sich nicht ftir diese Option entscheiden, dann wird 
die Verschliisselung der Version 4.5 verwendet. Sie sind dann nicht mehr in der Lage, das Modul mit friiheren Versionen 
von REALbasic zu verwenden. 


Um ein Modul zu sperren, selektieren Sie dieses im Projektfenster und wahlen Bearbeiten/Sperren oder wahlen Sie 
nach ctrl-Klick (Windows: Rechtsklick) auf den Modulnamen aus dem Kontextmenti den Mentipunkt Sperren aus. 
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Abb. 202: Das Kontextmenii im Projektfenster 


@ © © Namenios 


[@ Fensterl 


icy Mena 
i Gridlo Rearbeiten 
(i Modul éschen 
Es erscheint die Dialogbox zum Verschltisseln des Moduls. 
Abb. 203: Der Verschliisseln-Dialog 
GridLock verschlisseln 
PaRwort oes 


cal V3 Verschliisselung oder héher verw. 


(Abbrechen ) (Verschilissein) 


Geben Sie ein Passwort fiir die Verschliisselung ein und bestitigen Sie dieses. Selektieren Sie V3 Verschliisselung oder 
hoher verw. nur, wenn das Modul mit der Version 3-4 von REALbasic verwendet wird. 


Wenn Sie diese Option nicht aktivieren, wird die Verschliisselung der Version 4.5 verwendet. Sie kGnnen das Modul dann 
nicht mit REALbasic-Versionen kleiner 4.5 verwenden. 


Wichtig: Vergessen Sie nicht ihr Passwort. 
Ein gesperrtes Modul erscheint im Projektfenster mit einem Schltissel in der rechten unteren Ecke des Modul-Icons 
dit, . Wenn ein Anwender versucht, ein gesperrtes Modul im Fenstereditor zu 6ffnen, erscheint folgende Warnbox: 


Abb. 204: Der Dialog ,,Objekt verschliisselt” 


! Dieses Objekt wurde vom Autor 
verschlusselt - es kann nicht 
gedffnet werden 


CoD 


Um das Modul oder seinen Code zu bearbeiten, miissen Sie es mit dem entschliisseln. Selektieren Sie es dazu im Pro- 
jektfenster und rufen Sie den Meniipunkt Bearbeiten/Entschlisseln auf (bzw. Entschltisseln im Kontextmenii). 


Abb. 205: Der Entschliisseln-Dialog 


GridLock entsperren 


Pafwort: [eseeeees| 


Geben Sie das Passwort ein und klicken Sie auf Entsperren. Nach kurzer Zeit verschwindet der Schltissel aus dem Icon 
des Moduls, um anzuzeigen, dass die Entschliisselung erfolgreich war. Wenn Sie ein falsches Passwort eingegeben haben, 
informiert Sie eine Dialogbox dartiber. Ohne Passwort gibt es keine Moglichkeit, das Modul zu entschliisseln. 
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Kaiti? Text und Grafik verwenden 


Die allermeisten Programme miissen Texte oder Grafiken verarbeiten oder darstellen. Deshalb stellt REALbasic zahlrei- 
che Funktionen zum Erzeugen, Manipulieren, Anzeigen und Drucken von Texten und Grafiken zur Verftigung. 


Auf der Basis des Canvas-Steuerelements k6nnen eigene Steuerelemente entwickelt werden. 


Inhalt 


Verwenden von Fonts 

Verarbeiten von selektiertem Text 

Styled Text 

Verwenden von Text-Codierung (text encodings) 
Formatierung von Zahlen, Datums- und Zeitangaben 
Suchen mit regularen Ausdriicken 

Bilder und Grafik (Canvas Steuerelement und Graphics-Objekt) 
Bilder zeichnen 

Der Umgang mit Farben 

Drucken von Text und Grafik 

Text und Grafik tiber die Zwischenablage austauschen 
Animationen mit Sprites 

3D-Animation mit dem RB3DSpace-Steuerelement 


Verwenden von Fonts 


Fiir viele Objekte und Steuerelemente kénnen Sie die Schrift, die Schriftgr6%e und den Schriftstil frei wahlen. Edit- 
Field-Steuerelemente k6nnen mehrere Schriften in verschiedenen Stilen und Gréfen verwenden. Dies wird als Styled 
Text bezeichnet (mehr dazu siehe ,,Styled Text“ auf Seite 244). ListBoxen unterstiitzen ebenfalls unterschiedliche Schrift- 
stile. Steuerelemente, die eine einzelne Schrift verwenden, verfiigen tiber eine TextFont-Eigenschaft, mit der man diese 
Schrift festlegen kann. 


Der Systemfont und der kleine Systemfont 


Der Systemfont ist die Schriftart, die vom Betriebssystem als Standardfont eingesetzt wird. Er wird auch fiir die Mentis 
verwendet. 


Um Texte im Systemfont auszugeben, kGnnen Sie der TextFont-Eigenschaft des betreffenden Objekts im Eigenschaften- 
fenster den Wert ,,System“ zuweisen. Wenn Sie zusatzlich 0 (Null) als Schriftgr6fe einstellen, wird REALbasic automatisch 
die Schriftgrafe verwenden, die optimal ftir die Betriebssystemplattform geeignet ist, auf der Ihr Programm gerade lauft. 
Da z.B. Windows und Mac OS unterschiedliche dpi-Werte ftir die Bildschirmauflésung annehmen, werden auch unter- 
schiedliche Schriftgr6&en bendtigt. Wenn Sie die Schriftgr6&e 0 wahlen, verwendet Ihr Programm automatisch platt- 
formabhingig die passende Schriftgr6fse, ohne dass Sie fiir jede Plattform eigene Fenster kreieren miissen. 

‘shrift | 


TextFont: System e 


TextSize 
Bold: 
Italic: 


oooe 


Underline 
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Falls das verwendete Betriebssystem einen gro&en und einen kleinen Systemfont unterstiitzt, konnen Sie als TextFont 
auch ,,SmallSystem“ einstellen. Damit wird der kleine Systemfont aktiviert. Ist der kleine Systemfont nicht verfiigbar, 
wird statt dessen der Systemfont verwendet. 


Abb. 206: Systemfont und kleiner Systemfont unter Mac OS X 


Systemfont 


Kleiner Systemfont 


Welche Fonts sind verfiigbar? 


Wenn Sie nicht nur den Systemfont verwenden wollen, stellt sich die Frage, welche Fonts auf dem Computer des Benut- 
zers tiberhaupt verfiigbar sind. Mit den globalen Funktionen FontCount und Font konnen Sie auf einfache Weise feststel- 
len, ob ein Font vorhanden ist. Wenn Sie der folgenden Funktion einen Fontnamen tibergeben, liefert Sie True oder False 
zurtick, je nachdem, ob der Font gefunden wurde oder nicht: 


Function FontAvailable(FontName as String) As Boolean 
Dim i, nFonts as Integer 

nFonts=FontCount-1 

For i=0 to nFonts 

If Font(i)=FontName Then 

Return True 

End If 

ext 

Return False 

End Function 


Mit folgender kurzen Schleife kann ein PopupMenu oder eine ListBox mit allen verftigbaren Fonts aufgebaut werden: 


Dim i, nFonts as Integer 
nFonts=FontCount-1 

For i=0 to nFonts 
Me.AddRow Font(i) 

ext 


Wenn Sie in Ihrem Programm ein Schriftmenii benGtigen, konnen Sie dies folgendermafen realisieren: 
1. Legen Sie ein Meniti mit dem Namen ,,Schrift“ an und setzen Sie seine Text-Eigenschaft ebenfalls auf ,,Schrift*. 


2. Erzeugen Sie im Schrift-Menti einen neuen Meniipunkt und tragen in dessen Text-Eigenschaft FontName ein. REAL- 
basic wird den neuen Mentipunkt automatisch SchriftFontName nennen. 


3. Setzen Sie die Index-Eigenschaft des Mentipunkts auf 0 (null) 


4. Legen Sie das folgende Programmstiick in den Open-Event-Handler der App-Klasse: 
Dim m as Menultem 

Dim i, nFonts as Integer 

nFonts=FontCount-1 

SchriftFontName(0).text=Font(0) 

For i=l to nFonts 

m=New SchriftFontName 

m.text=font(i) 

next 


Alle so erzeugten Meniieintrége konnen sich einen Menu-Handler teilen. Diesem wird ein Index tibergeben, der dartiber 
Auskunft gibt, welcher Meniipunkt ausgewahlt wurde. Zusammen mit der Font-Funktion kann dieser Index dazu ver- 
wendet werden festzustellen, welche Schrift ausgewahlt wurde. 
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Im REALbasic-Tutorial programmieren Sie ein Font-Menii, das ein BevelButton-Steuerelement an Stelle eines Meniis in 
der Meniileiste verwendet. Das Font-Menii wird mit der AddRow-Methode des BevelButton-Steuerelements erzeugt. 
Dim i, nFonts as Integer 
nFonts=FontCount-1 
For i=0 to nFonts 

me.AddRow Font(7) 
Next 
me.Caption=TextField.SelTextFont 
Die letzte Zeile der Methode weist den BevelButton an, den Font, der gerade im Texteditor-Programm verwendet wird, 
anzuzeigen. 


Sie k6nnen die gleiche Logik verwenden, um ein Font-Menti mit einem PopupMenu-Steuerelement zu erzeugen, da 
auch dieses eine AddRow-Methode besitzt. 


Verarbeiten von selektiertem Text 


Der Begriff ,,selektierter Text“ bezieht sich auf Textteile, die in einem EditField selektiert (also grafisch — meist durch 
Invertieren — hervorgehoben) sind, das gerade den Fokus besitzt. EditFields haben drei Eigenschaften, die dazu dienen, 
selektierten Text auszulesen oder Text zu selektieren. 


Tabelle 13. Eigenschaften, um selektierten Text zu erhalten oder zu produzieren 


Name Beschreibung 

Sellength Die Anzahl der gegenwartig ausgewahlten Zeichen. Wenn Sie diese Zahl andern, verdndert sich die 
Selektion. Setzen Sie den Wert auf 0 (null), wird die Selektion aufgehoben und der Cursor landet auf der 
Position, die in SelStart angegeben ist. 

SelStart Die Zahl der nicht selektierten Zeichen vor dem selektierten Text. Selektiert man beispielsweise das flinfte 
Zeichen eines Textes, steht in SelStart eine Vier. Setzt man den Wert auf Null, beginnt die Selektion am 
Anfang des EditFields. 

SelText Eine Zeichenkette, die den gesamten selektierten Text enthalt. Wird hier ein anderer Inhalt abgelegt, wird 
der selektierte Text durch diesen ersetzt. Ist kein Text selektiert, dann wird der in SelText geschriebene 
String an der Einfiigemarke (Wert von SelStart) ausgegeben. 


Folgende Zeilen wahlen den gesamten Text in dem EditField aus, das gerade den Fokus hat: 


EditFieldl.SelStart=0 
EditFieldl.SelLength=Len(EditField1.Text) 


Soll ein bestimmter Programmcode ausgeftihrt werden, wenn der Benutzer den Cursor bewegt oder einige Zeichen 
selektiert, dann stecken Sie den Code dazu in den SelChange-Event-Handler des EditFields. 


Anlegen eines Passwort-Feldes 


EditFields haben die Eigenschaften Password und LimitText, die man ftir Passwort-Felder verwenden kann. Ist die Eigen- 
schaft Password gesetzt, dann werden Buchstaben als Punkte (*) ausgegeben. Die korrekten Buchstaben landen aber 
dennoch in der Text-Eigenschaft des EditFields. Mit der Eigenschaft LimitText kann man die Maximallinge eines Textes 
im EditField vorgeben. 


Achtung: Die Password-Eigenschaft funktioniert nur dann, wenn die Eigenschaft Multiline nicht aktiviert, also False ist. 
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Textfeldeingaben formatieren und filtern 


Das EditField besitzt zwei Eigenschaften, die es Ihnen erlauben, den eingegebenen Text Zeichen fiir Zeichen zu formatie- 
ren und zu filtern. Dies kann zum Beispiel ftir eine Datenbank-Eingabemaske verwendet werden, in der die Kunden- 
nummer das Format ,,12-123-1234* erfiillen muss. 


Die Format-Eigenschaft 


Die Format-Eigenschaft eines EditFields erlaubt es, den eingegebenen Wert anders darzustellen, als er tatsachlich einge- 
geben wurde. So kénnen Sie beispielsweise Zahlen immer mit zwei Stellen hinter dem Komma darstellen. Wenn das 
EditField den Fokus erhalt, wird die Eingabe ohne Formatierung angezeigt. Ohne Fokus wird der Wert mit entsprechen- 
der Formatierung angezeigt. Die unterstiitzten Formate entsprechen denen der Format-Funktion. Lesen Sie dazu den 
Eintrag tiber die Format-Funktion in der Sprachreferenz. Um die Formatierung zu loschen, geben Sie zwei Anfiihrungs- 
zeichen an (einen leeren String). Hier einige Beispiele: 


// Zahlen immer mit zwei Dezimalstellen anzeigen, notfalls mit Nullen auffiillen. 
Editfieldl.format = "0.00" 


// Zahlen maximal mit zwei Dezimalstellen anzeigen, aber nicht mit Nullen auffiillen. 
Editfieldl.format = "JE. dH" 


// Die Formatierung aufheben 
Editfieldl.format = "" 


Die Mask-Eigenschaft 


Mit Hilfe der Mask-Eigenschaft, filtern Sie die Eingabe und k6nnen diese somit auf bestimmte Zeichen beschranken. So 
k6nnen Sie die Eingabe der oben erwahnten Kundennummer tiberpriifen, die ein bestimmtes Format aufweisen muss. 
Jedes Zeichen in der Maske steht als Platzhalter ftir einen bestimmten Typ von Zeichen oder ein Zeichen selbst. 


Die Eingabemaske ist vollstandig mit Visual Basic kompatibel, mit einer Ausnahme: ,,~“ ist in REALbasic ftir zuktinftige 
Nutzung oder Erweiterungen reserviert. 


Besitzt ein EditField eine Eingabemaske, wird dies dem Benutzer nicht kenntlich gemacht, bis dieser nicht erlaubte Ein- 
gaben macht. 


Lesen Sie auch den Eintrag zum EditField in der Sprachreferenz. 
Hier ein paar Beispiele: 


// Erlaubt eine Kundennummer, wie weiter oben beschrieben. (Nur Ziffern) 
Editfieldl.Mask = "dHF-dHHE-dHHHE" 

// Erlaubt ein Datum in der Form 14-Dec-1972 

Editfieldl.Mask = "#HF-???-dHHHE" 

// Automatische GroBschrift einer Registriernummer der Form AWS-1925-ASD 
Editfieldl.Mask = ">???-/HHHE-222" 

// Eingabemaske entfernen 

Editfieldl.Mask = "" 


Styled Text 


Styled Text bedeutet, dass der betreffende Text nicht nur aus einem Font in einer Grose und mit einem Schriftstil beste- 
hen muss. Um Styled Text in einem EditField verwenden zu konnen, miissen die Eigenschaften MultiLine und Styled ein- 
geschaltet (True) sein. Um Styled Text auszudrucken, miissen Sie die Klasse StyledTextPrinter verwenden (siehe 
Seite 274). 
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Ermitteln von Font, GroBe und Stil des Textes. 


Die EditFields haben Eigenschaften, die es leicht erméglichen, den Font, seine Gro8e und seinen Stil zu ermitteln. Die 
Eigenschaft SelTextFont kann verwendet werden, um den Font der gerade aktiven Selektion zu bestimmen. Besteht 
diese nur aus einem Font, enthalt SelTextFont den Namen dieses Fonts. Sind es mehrere Fonts, so ist SelTextFont leer. 


Die folgende Funktion ermittelt die in einer Selektion verwendeten Fonts. Dazu wird gegebenenfalls in einer Schleife fiir 
jedes Zeichen in der Selektion der Font bestimmt: 


Function Fonts(item as EditField) as String 
Dim fonts, theFont as String 

Dim i, Start, Length as Integer 

f Field.SelTextFont="" Then 
Start=Field.SelStart 
Length=Field.SelLength 

For i=Start to Start+Length 
Field.SelStart=i 

Field.SelLength=1 

If InStr(fonts,Field.SelTextFont)=0 Then 
If fonts="" Then 

onts=Field.SelTextFont 

Else 
fonts=fontst", "+Field.SelTextFont 
End if 

End if 

Next 
Return fonts 

Else 

Return Field.SelTextFont 
End If 

End Function 


Die Eigenschaft SelTextSize wird dazu verwendet, die Font-Gro8e des selektierten Textes zu speichern und wird analog 
zu SelTextFont benutzt. Haben alle Zeichen der Selektion die gleiche Gréfe, steht diese in SelTextSize. Ist dies nicht der 
Fall, so steht dort eine 0. 


Es gibt aufserdem boole’sche Eigenschaften, mit denen man ermitteln kann, ob alle Zeichen eines selektierten Textes 
einem bestimmten Schriftstil entsprechen. Da in einem Text mehrere Stilvarianten gleichzeitig verwendet werden k6n- 
nen, bestimmen diese Eigenschaften lediglich, ob allen Zeichen des selektierten Textes ein bestimmter Schriftstil zuge- 
wiesen wurde. 


Wenn beispielsweise alle Zeichen des selektierten Textes den Schriftstil fett (bold) besitzen und einige Zeichen zusatzlich 
kursiv (italic) sind, liefert ein Test auf bold den Wert True zurtick. Der Test auf italic liefert False zurtick, da nicht alle Zei- 
chen des selektierten Textes den Schriftstil italic besitzen. 


Fiir jede dieser Eigenschaften miissen alle Zeichen tiberpriift werden, um dann den Wert False oder True zu ermitteln. 
Zum Testen der Attribute wird im Programm einfach eine Selektion ftir jeweils genau ein Zeichen gesetzt und dann wer- 
den dessen Attribute einzeln abgefragt. Dies ahnelt dem Vorgehen beim Ermitteln des verwendeten Fonts. Die Eigen- 
schaften fiir die verschiedenen Schriftstile sind folgende: 


Tabelle 14. Eigenschaften die eine Schriftart testen 


Eigenschaft Stil 

SelBold Fett (Bold) 

Selltalic Kursiv (Italic) 
SelUnderline Unterstrichen (Underline) 
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Tabelle 14. Eigenschaften die eine Schriftart testen 


Eigenschaft Stil 


Se/Outline Umrandet (Outline) 

SelShadow Schattiert (Shadow) 

SelCondense Schmal (Condensed) 
SelExtend Breit (Extended) 


Die Stilarten Outline, Shadow, Condensed und Extend werden nur von Mac OS Classic untersttitzt. 
So aktiviert man den Meniipunkt Fett (bold), wenn der selektierte Text fett ist: 
StyleBold.Checked=EditField1.SelBold 


Ist keines der Zeichen in der Selektion fett, dann liefert EditField1.SelBold den Wert False, der dann der Eigenschaft Che- 
cked des Mentipunktes StyleBold zugewiesen wird. 


Setzen von Schrift, GroBe und Stil 


Die Eigenschaften, die zur Ermittlung von Schrift, Groe und Stil dienen, werden auch dazu verwendet, diese Attribute 
zu verandern. Um beispielsweise einer Selektion den Font Helvetica zuzuweisen, schreiben Sie folgendes: 
Editfieldl.SelTextFont="Helvetica" 

Denken Sie daran, dass das nur dann funktionieren kann, wenn der Font auch im System des Benutzers installiert ist. 
Sonst passiert bei der Zuweisung gar nichts. Mit der bereits angesprochenen Funktion FontAvailable kann man heraus- 
finden, ob ein bestimmter Font vorhanden ist. 

Die Schriftgrd&e des selektierten Textes kann mittels Sel'TextSize ge’indert werden. Eine Anderung auf 12 Punkt erreicht 
man so: 

Editfieldl.SelTextSize=12 

Um einen bestimmten Stil zuzuweisen, setzen Sie einfach das zugehGrige Attribut auf True. Fett macht man den Text also 
SO: 

Editfieldl.SelBold=True 

Tabelle 14 auf Seite 245 zeigt alle Stil-Eigenschaften von EditFields, die alle in derselben Art und Weise benutzt werden 
k6nnen. 

Die EditFields verftigen auch tiber Methoden, mit denen die Stile ein- und ausgeschaltet (toggle) werden k6nnen. Durch 
ein Toggle-Kommando werden alle Zeichen, bei denen das entsprechende Stilattribut nicht gesetzt ist, mit diesem Attri- 
but versehen und bei allen Zeichen, bei denen es gesetzt ist, wird es geldscht. Dazu ruft man die Toggle-Methode fiir das 
entsprechende Attribut auf: 

Editfieldl.ToggleSelectionBold 

Die Toggle-Methoden finden Sie in der folgenden Tabelle: 


Tabelle 15. Methoden zur Veranderung des Stils 


Methode Stil 
ToggleSelectionBold Bold/Fett 
ToggleSelectionitalic Italic/Kursiv 


ToggleSelectionUnderline — Underline/Unterstrichen 
ToggleSelectionOutline Outline/Umrandet 
ToggleSelectionShadow Shadow/Schattiert 
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Tabelle 15. Methoden zur Veriinderung des Stils 


Methode Stil 
ToggleSelectionCondense Condensed/Schmal 
ToggleSelectionExtend Extended/Breit 


Outline, Shadow, Condensed und Extend werden nur unter Mac OS Classic unterstiitzt. 


Arbeiten mit StyledText Objekten 


Wenn Sie mit formatiertem Text in einem EditField arbeiten, konnen Sie die Eigenschaften des EditFields zum Setzen 
und Auslesen von Stil-Attributen nutzen (siehe oben). REALbasic bietet Ihnen auch die Méglichkeit, formatierten Text 
unabhangig von einem EditField zu verwenden. Daftir werden die Methoden und Eigenschaften der StyledText-Klasse 
verwendet. Die Eigenschaft Text enthalt den formatierten Text, der von dem StyledText-Objekt verwaltet wird. Dazu gibt 
es noch sechs weitere Eigenschaften, mit denen Sie die Formatierung des Texts modifizieren oder auslesen k6nnen. 


Tabelle 16. Eigenschaften zum Setzen und Auslesen der Formatierung 


Name Beschreibung 


Bold Auslesen oder Setzen des Fettschrift-Attributs des markierten Texts. 
Font Auslesen oder Setzen der Schriftart des markierten Texts. 

Italic Auslesen oder Setzen des Kursiv-Attributs des markierten Texts. 
Size Auslesen oder Setzen der SchriftgréBe des markierten Texts. 


TextColor Auslesen oder Setzen der Schriftfarbe des markierten Texts. 
Underline Auslesen oder Setzen des Unterstreichen-Attributs des markierten Texts. 


Jede Eigenschaft akzeptiert Parameter fiir die Startposition und die Anzahl der Zeichen. Wenn Sie zum Beispiel die Fett- 
schrift fiir einen bestimmten Text verwenden mochten, sdhe ein Aufruf so aus: 


Dim st as StyledText 

st.Text="Dies ist fett geschrieben” 

st.Bold(9,4)=TRUE 

Damit wird das Wort ,,fett“ in Fettschrift geschrieben. Eine Folge von Zeichen mit identischen Attributen bildet ein Style- 
Run-Objekt. Im Beispiel gibt es drei StyleRun-Objekte. Die Zeichen bis zum Wort ,,fett“, das Wort ,,fett“ selbst und die 
restlichen Zeichen. Jedes StyleRun-Objekt ist die Ausprégung einer Zeichenformatierung im Sinne einer Textverarbei- 
tung. Die gesamte Eigenschaft Text besteht aus solchen StyleRun-Objekten. 


Die StyledText Klasse besitzt sechs Methoden, um StyleRun-Objekte zu verwalten: 


Tabelle 17. Methoden zum verwalten von StyleRun-Objekten 


Name Beschreibung 

AppendstyleRun Fugt ein StyleRun am Ende des Texts an. 

InsertStyleRun Fugt ein StyleRun an der angegebenen Position ein. 

RemoveStyleRun Entfernt das angegebene StyleRun aus dem Text. 

StyleRun Bietet Zugriff auf ein StyleRun. Die StyleRun Klasse besitzt eigene Eigenschaften, die die 
vorhandene Zeichenformatierung beschreiben. 

StyleRunCount Liefert die Anzahl der StyleRun-Objekte, die zusammen den Text bilden. 

StyleRunRange Bietet Zugriff auf die Start- und Endposition, sowie die Lange des StyleRun-Objekts. 


Der Text eines StyledText-Objekts kann aus mehreren Absatzen bestehen. Als Absatz bezeichnet man einen Textbereich, 
der sich zwischen zwei Zeilenenden (newline) befindet. Ein Absatz kann entweder mit Hilfe der EndOfLine-Funktion 
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oder mit einem Zeilenende definiert werden. Das Zeilenende ist ein Zeichen, das sich je nach Plattform unterscheidet. 
Es gilt jeweils das Zeichen der Plattform, auf der das Programm ausgeftihrt wird. Ein Absatz kann aus mehreren Style- 
Run-Objekten bestehen. Der Absatz selbst besitzt nur eine Eigenschaft, die Textausrichtung (links, zentriert, rechts). 


Es gibt drei Methoden der StyledText Klasse, die sich auf Absatze beziehen: 
Tabelle 18. Methoden, die sich auf Absatze beziehen 


Name Beschreibung 

Paragraph Bietet Zugriff auf einen Absatz im Text. Die Paragraph-Klasse bietet eigene Eigenschaften 
fir die Start- und Endposition, sowie die Lange und Ausrichtung eines Absatzes. 

ParagraphCount Liefert die Anzahl der Absatze, aus denen der Text besteht. 


SetParagraphAligment Bestimmt die Ausrichtung des Absatzes (links, zentriert, rechts). 


Auch wenn Sie mit einem StyledText-Objekt in Ihrem Code arbeiten k6nnen, ohne dies jemals anzuzeigen, steht ein 
EditField immer mit einem StyledText-Objekt in Zusammenhang. Dieses Objekt konnen Sie tiber die Eigenschaft ,,Styled- 
Text“ des EditFields erreichen. Wenn Sie mit dem StyledText-Objekt eines EditFields arbeiten wollen, miissen Sie die 
Eigenschaften ,,MultiLine“ und Styled“ im Eigenschaftenfenster des EditFields aktivieren. 


Beispiel: Die Zeile 


EditField1.StyledText="Dies ist mein formatierter Text.” + EndOfLine _ 
+ “Ist das nicht beeindruckend?” 


Setzt den Inhalt des EditFields und zeigt den Text an. Jetzt konnen Sie den Text formatieren: 


Dim st,In as Integer 

Dim Text as String 

Text="Dies ist mein formatierter Text."+EndOfLinet+"Ist das nicht beeindruckend?” 
EditField1.StyledText.Text=Text 


//Schriftart und SchriftgréBe dem gesamten Text zuweisen 
EditField1.StyledText.Font(0,Len(Text) )="Arial" 
EditField1.StyledText.Size(0,Len(Text) )=14 


//Die Zeichen des Worts “mein” im ersten Absatz hervorheben. 
EditField1l.StyledText.Bold(9,4)=True 
EditField1.StyledText.textColor(9,4)=&cFFO000 //Rot 


//Position des zweiten Absatzes ermitteln (Positionsindex beginnt bei 0). 
st=EditFieldl.StyledText.Paragraph(1).StartPos-1 
In=EditField1.StyledText.Paragraph(1).Length 


//Zweiten Absatz fett darstellen 
EditField1.StyledText.Bold(st,1n)=True 
//Zweiten Absatz zentrieren 
EditFieldl.StyledText.ParagraphAlignment(1)=1 


e800 Namenlos 


Dies ist mein formatierter Text. 
Ist das nicht beeindruckend? 
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In diesem Beispiel wird das StyledText-Objekt des EditFields verwendet, aber Sie k6nnen nattirlich auch ein eigenes Sty- 
ledText-Objekt mit Hilfe der Dim-Anweisung erzeugen und dies ohne Bezug auf ein Steuerelement verwenden. Wenn 
Sie es bearbeitet haben und darstellen wollen, konnen Sie es der StyledText-Eigenschaft eines EditFields zuweisen. 

Dim st as StyledText 

// Tun Sie, was immer Sie mit dem Text tun wollen 

EditField1l.StyledText=st 

Sie konnen den Text auch als eine Folge von StyleRun-Objekten exportieren und — nachdem Sie ihn wieder importiert 
haben — mit Hilfe der AppendStyleRun-Methode wieder zusammensetzen. Weitere Informationen tiber StyleRun- und 
StyledText-Objekte finden Sie in der Sprachreferenz. 


Arbeiten mit Textcodierungen 


Jeder Computer verwendet eine bestimmte Codierung, wenn er Zeichenketten als eine Reihe von Bytes speichert. Die 
alteste und bekannteste Codierung ist wohl ASCII. ASCII definiert Zeichen fiir den Wertebereich 0-127. Dieser Wertebe- 
reich beinhaltet das englische Alphabet, Ziffern, einige Symbole und unsichtbare Steuerzeichen, die in friiheren Compu- 
tern verwendet wurden. Sie konnen die Chr-Funktion benutzen, wenn Sie das ASCII-Zeichen eines Werts bendtigen. 


Es wurden einige Erweiterungen zu ASCII eingeftihrt, die zusatzliche Symbole, Zeichen mit Akzent oder nicht-rémische 
Alphabete codieren. Eine weitere Codierung, Unicode genannt, wurde eigens daftir entwickelt, um samtliche Sprachen 
und auch Mixturen der Sprachen in einer Zeichenkette (string) zu ermdglichen. REALbasic bietet zwei Unicode-Codie- 
rungen, UTF-8 und UTF-16. Alle Konstanten, Strings und so weiter, werden intern UTF-8 codiert. 


Wenn der String in REALbasic erzeugt, gespeichert und wieder geladen wurde, brauchen Sie sich keine Gedanken um 
die Codierung zu machen, da REALbasic die Codierung des Strings mit dem String speichert. Dies gilt auch ftir die REAL- 
database-Engine. 


Wenn Sie allerdings Strings verwenden, die auerhalb von REALbasic erzeugt oder geandert wurden, miissen Sie verste- 
hen, wie die Textcodierung funktioniert und welche Anderungen nétig sind, damit die Verarbeitung der Texte weiterhin 
reibungslos funktioniert. 


Textcodierung: Von ASCII zu Unicode 


Wie Sie bereits wissen, speichert der Computer keine Zeichen, sondern nur numerische Werte, die er den Zeichen 
zuordnet. Zum Beispiel hat ein Zeilenumbruch in ASCII den Wert 13. 


Als die Computerindustrie noch in den Kinderschuhe steckte, verwendete jeder Computerhersteller eine eigene Num- 
merierung, einen sogenannten Zeichensatz (character set). Dieser legte die Zuordnung vom numerischen Wert zu Zei- 
chen (Buchstaben, Ziffern, Steuerzeichen, etc.) fest. Mit einem solchen Zeichensatz (character set) konnte man 
Informationen zwischen den verschiedenen Computern austauschen. 


1963 verabschiedete die American Standards Association (die spater in American National Standards Institute umben- 
annte wurde) den ,,American Standard Code for Information Interchange“, kurz ASCII, der auf dem Zeichensatz einer 
englischen Schreibmaschine basierte. 


Im Laufe der Zeit wurden Computer auch au&erhalb der USA popular und allmahlich zeigten sich die Schwachen von 
ASCIL Die ASCI-Codierung kannte nur 128 Zeichen. Diese umfassten neben den Zeichen einer englischen Schreibma- 
schine einige Steuerzeichen, um die Ausgabe des Computers zu manipulieren, kannten aber keine Sonderzeichen, die 
beispielsweise haufig in Biichern verwendet wurden (typografische Anfiihrungszeichen, Apostroph, Punktsymbol fiir 
Aufzahlungen). Auch viele Sprachen, wie Franzdsisch oder Deutsch, waren nicht Teil von ASCIL. 


Als der Macintosh und Windows eingeftihrt wurden, besafs jedes Betriebssystem eine eigene Erweiterung zu ASCII, ftir 
den Wertebereich 128-255. Damit waren die Betriebssysteme in der Lage, auch Zeichen mit Akzent oder Umlaute zu 
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unterstiitzen. Leider waren diese beiden Erweiterungen nicht kompatibel. Cross-Plattform-Applikationen bendotigten 
deshalb eine eigene Komponente, um mit dem erweiterten Zeichensatz umzugehen. 


Das Problem wird allerdings gr6fer, wenn es um Sprachen geht, die kein romisches Alphabet verwenden, wie zum Bei- 
spiel Japanisch, Chinesisch oder Hebriisch. Aufgrund der Fille von Zeichen wurden Zeichensatze erfunden, die zwei 
Bytes zur Zeichencodierung verwendeten. 


Auch Apple erzeugte einige Textcodierungen, um den Umgang mit Daten zu vereinfachen. MacRoman ist die Codierung, 
die fiir Dateien mit ASCII-Zeichen verwendet wird. MacJapanese ist fiir Dateien gedacht, die japanische Zeichen enthal- 
ten. Es gibt noch weitere, aber sie alle sind Mac-spezifisch. Der Datenaustausch zwischen den verschiedenen Systemen 
wurde dadurch nicht einfacher, und auch das Mischen mehrerer Sprachen in einem Dokument blieb problematisch. 


Es wurde klar, dass eine umfassende Codierung entwickelt werden musste, die alle vorhandenen Zeichen fiir alle Spra- 
chen codieren konnte. Diese universelle Codierung wurde von einem Xerox-Mitarbeiter, der an der Entwicklung betei- 
ligt war, ,Unicode“ genannt. Unicode schlief&lich ldste all diese Probleme. Jedes beliebige Zeichen wiirde auf allen 
Computern gleich sein, sofern diese Unicode unterstiitzten. Mehr noch, Unicode erméglicht es, Sprachen in einem 
Dokument zu mischen, da alle Sprachen in einer Codierung untergebracht waren. 


Die Unterstiitzung von Unicode wurde auf dem Mac mit System 7.6 und unter Windows mit Windows 95 eingefiihrt. Es 
war nun moglich, Dateien zwischen den verschiedenen Codierungen zu konvertieren, aber Unicode war immer noch 
die Ausnahme, nicht die Regel. Erst mit Mac OS X und Windows 2000 anderte sich dies. 


Momentan ist man als Computerbenutzer in einer Zwickmiihle. Einerseits arbeiten neuere Systeme durchweg mit Uni- 
code, andererseits wird immer noch mit alteren Systemen gearbeitet. Im Ergebnis kann es deshalb vorkommen, dass Sie 
doch mit unterschiedlichen Codierungen umgehen miissen. Zumindest fiir eine Ubergangszeit. Das bedeutet, dass Sie 
Ihren Code entsprechend anpassen miissen. In Zukunft wird man annehmen kénnen, dass eine Datei in Unicode 
codiert ist, aber bis dahin werden Sie Ihre Applikationen so anpassen miissen, dass sie mit unterschiedlichen Codierun- 
gen umgehen kénnen. 


Anpassen des Codes fiir unterschiedliche Textcodierungen 

Leider gibt es keinen 100% akkuraten Weg, die Codierung einer Datei zu ermitteln. Sie sollten daher wissen, in welcher 
Codierung die Datei vorliegt. Kommt die Datei beispielsweise von einem englischsprachigen Mac-Benutzer, so wird die 
Codierung héchstwahrscheinlich MacRoman sein. Bei einem englischsprachigen Windows-Benutzer wohl Win- 
dowsANSI. Wenn die Codierung eines Strings definiert ist, konnen Sie diese folgendermafen ermitteln: 
TextEnc=Encoding(s) 


Bei diesem Beispiel enthilt die Variable s den Text und TextEnc ist ein Objekt vom Typ TextEncoding. Ist keine Codierung 
definiert, wird Nil zuriickgegeben. 


Lesen von Textdateien 


Im folgenden Beispiel wird eine Textdatei eingelesen und in einem EditField angezeigt. Dabei werden keine Annahmen 
iiber die Codierung gemacht und der Text wird, falls nicht in Unicode codiert, méglicherweise nicht korrekt dargestellt. 
Das Beispiel wurde absichtlich kurz gehalten, um nicht vom Thema Codierung abzulenken. 

Dim f As FolderItem 

Dim t as TextInputStream 

f = GetFolderItem("Beispiel.txt") 

t = f.OpenAsTextFile 

Editfieldl.text = t.ReadAll 

t.close 


Wenn Sie die Codierung der Datei wissen, kénnen Sie das Beispiel schnell und einfach anpassen, um den Text mit kor- 
rekter Codierung einzulesen. Die TextInputStream-Klasse besitzt eine Encoding-Eigenschaft, mit der Sie die Codierung 
fiir den einzulesenden Text angeben. Dabei spielt es keine Rolle, ob Sie die Read- oder ReadAll-Methode verwenden. 
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Im nun geanderten Beispiel wird die Codierung auf MacRoman gesetzt. Die Datei wird nun korrekt eingelesen, da diese 
tatsdchlich in MacRoman codiert ist. 


Dim f As FolderItem 

Dim t as TextInputStream 

f = GetFolderItem("Beispiel.txt") 

If f<> Nil Then 
t = f.OpenAsTextFile 
t.Encoding = Encodings.MacRoman 
Editfieldl.text = t.ReadAll 
t.close 

End if 


In der Zeile, in der die Codierung gesetzt wird, wird das Encodings-Objekt verwendet. Dieses Objekt enthalt Funktionen 
fiir alle mdglichen Codierungen. Die Standardcodierung ist UTF-8, ein spezielles Format von Unicode. Wenn Sie ,,Enco- 
dings“ im Code-Editor eingeben und dann die Tabulatortaste driicken, wird die automatische Vervollstandigung des Edi- 
tors Ihnen alle verftigbaren Codierungen anzeigen. 


Sie konnen die Codierung auch als Parameter ftir die Methoden Read und ReadaAll angeben, statt sie der Encoding-Eigen- 
schaft zuzuweisen. 


Schreiben von Textdateien 


Wenn Ihre Applikation eine Datei in einer bestimmten Codierung speichern soll, mtissen Sie dies beim Speichern ange- 
ben. Dieser Fall kann eintreten, wenn die Datei unter einem anderen Betriebssystem oder in einem anderen Land verar- 
beitet werden soll. 


Sie verwenden die ConvertEncoding-Funktion, um Text zwischen verschiedenen Codierungen zu konvertieren. Hier ist 
ein einfaches Beispiel, das den Text eines EditFields als MacRoman-codiert in einer Datei speichert. Mit Hilfe der 
ConvertEncoding-Funktion wird der Text vor dem Schreiben in die andere Codierung konvertiert. 
Dim f As FolderItem 
Dim t as TextOutputStream 
f = GetFolderItem("Beispiel.txt") 
If f<> Nil Then 

t = f.CreateTextFile 

t.Write ConvertEncoding(Editfieldl.text, Encodings.MacRoman) 

t.close 
End if 
Wenn eine Applikation eigene Dateien schreibt und liest, brauchen Sie sich dartiber keine Gedanken zu machen. Es wird 
grundsatzlich die Codierung UTF-8 angenommen. Wenn Sie also Dateien schreiben und nichts weiter angeben, werden 
diese in Unicode geschrieben. Dies gilt auch fiir das Lesen. 


Ermitteln eines einzelnen Zeichens 


Wie schon erwahnt, benGtigen Sie die Chr-Funktion, wenn Sie ein einzelnes ASCII-Zeichen aus seinem numerischen 
Wert erzeugen mochten. Die Chr-Funktion funktioniert nur ftir ASCII-Zeichen im Wertebereich 0 bis 127. 


Fiir andere Werte und Codierungen verwenden Sie die Chr-Methode der TextEncoding Klasse. Um die Chr-Methode ver- 
wenden zu konnen, miissen Sie die Codierung festlegen und einen numerischen Wert angeben, dessen Zeichen Sie 
ermitteln wollen. Dies sieht dann folgendermafen aus: 

Dim s as String 

s=Encodings.MacRoman.Chr(170) 

Wie Sie sehen, wird hier die Chr-Methode fiir die MacRoman-Codierung aufgerufen. Dadurch wird die Codierung, ftir 
die Sie ein Zeichen ermitteln wollen, implizit angegeben. Das Ergebnis ware ein ,,""“ 
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Formatierung von Zahlen, Datums- und Zeitangaben 


Zahlen 


Zahlen werden formatlos gespeichert. Um Zahlen zu formatieren, tibergibt man der Formatierungsfunktion den Zahlen- 
wert und eine Formatierungsanweisung und erhalt eine formatierte Zeichenkette zurtick: 


result=Format(Number, FormatSpec) 


FormatSpec ist eine Zeichenkette, die ein oder mehrere Zeichen enthilt, die die Formatierung der Zahl bestimmen. Die 
Angabe ,$###,# #0.00" in FormatSpec fiihrt zur typischen Ausgabe eines Geldbetrages in US-Dollar. 


Tabelle 19. In Forma 


Spec verwendete Zeichen 


Zeichen 
# 


E oder e 
\character 


Funktion 
Platzhalter, an desse 
genug ist. 
Platzhalter, an desse 
genug ist. Ist an dies 


n Stelle eine Ziffer des anzuzeigenden Wertes ausgegeben wird, sofern die Zahl lang 


n Stelle eine Ziffer des anzuzeigenden Wertes ausgegeben wird, sofern die Zahl lang 
er Stelle der Zahl keine Ziffer auszugeben, wird eine 0 ausgegeben. 


Platzhalter fiir die Position des Dezimalpunktes. (US-Format) 


Platzhalter, an desse 
Ausgabe der Zahl na 


n Stelle das Komma als Dezimaltrenner erscheinen soll. (US-Format) 
ch Multiplikation mit 100. 


Ausgabe einer offnenden Klammer. 


Ausgabe einer schlie 
Links von der Zahl w 


Benden Klammer. 
ird ein Pluszeichen ausgegeben, wenn es sich um eine positive Zahl handelt, ein 


Minuszeichen dagegen bei einer negativen Zahl. 


Links von der Zahl w 


ird ein Minuszeichen ausgegeben, wenn es sich um eine negative Zahl handelt. Bei 


einer positiven Zahl wird nichts ausgegeben. 


Ausgabe der Zahl in 


Exponentendarstellung. 


Ausgabe des Zeichens, das auf den Backslash folgt (anstelle des Worts ,,character”). 


Im Classic Mac OS wird das Zeichen, das als Tausender- und Dezimaltrennzeichen verwendet wird, vom Anwender im 
Zahlenformat-Kontrollfeld festgelegt. Unter Mac OS X werden diese Zeichen bei den Landeseinstellungen im Karteirei- 
ter ,Zahlen“ eingestellt. Unter Windows stellt man das Zahlenformat bei den Landereinstellungen ein. 
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Abb. 207: Kontrollfeld ,,Zahlenformat” von Mac OS 9, Landeseinstellungen von Mac OS X und Landereinstellungen von Windows 


0 > Zahlenformat =——BH Eigenschaften von Landereinstellungen 12] x] 
a Zahlenformate: L&ndereinstellungen Zahlen | watwung | Uhvzeit | Datum | 
Trennzeichen wahrung Darstellung 
Dezimal: iE (=) Symbol: | DM __ 
Vor der Zahl 
Tausender: |. Ea} @ 
@ Nach der Zahl Desmalianren : ,.Tti(Csi‘ HT 
Peboel Saal Anzahl der Dezimalstellen: [2 x 
1.234,56 DM 
—_——— Symbol fur Ziffermaruppierung: je! 
Anzahl der Ziffem je Gruppe: 3 z 
"ee Landeseinstellungen =_ 
a = = Negatives Vorzeichen: i Y 
ie i) re iit 
Alle einblenden _ Monitore Ton Netzwerk Startvolume ome Re reaiye cee aa! | 
Fihrende Nullen anzeigen: oO? zx 
f Sprachen | Datum | Uhrzeit Tastaturmentt } 
Mafisystern: [Metisch =] 
Listentrennzeichen: 7 hd 


Region: _ Deutsch i) 


Trennzeichen Wahrung Ma&system 


Abbrechen | b=inetmnen 
Dezimal: , is] Symbol: € O US-Standard 
@ Metrisch 
Tausender: . |} O Vor der Zahl 
® Nach der Zahl 
1.234,56 € 


FormatSpec wendet das angegebene Format auf alle Zahlen an. Wenn Sie unterschiedliche Formate ftir positive und 
negative Zahlen und die Null haben mochten, dann geben Sie diese Formatanweisungen einfach durch Semikolon 
getrennt in FormatSpec an (wie bei den letzten drei Beispielen in der Tabelle: 


Tabelle 20. Verschiedene FormatSpecs 


Format Syntax Ergebnis 
Format(1.784, "#.##") 1.78 
Format(1.3, "#.0000") 1.3000 
Format(5, "0000") 0005 
Format(.25, "#%") 25% 
Format(145678.5, "#.##") 145,678.5 
Format(145678.5, "###e+") 146e+5 
Format(-3.7, "-#.##") -3.7 
Format(3.7, "+#.##") 43.7 
Format(3.7, "#.4#; (#.##); \n\ullll") 3.7 
Format( -3.7, "#.##; (#.##); \nlullll") (3.7) 
Format(0, "#.##; (#.##); \n\ull\l”) null 
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Datumsangaben 


Datumsangaben sind Objekte, deren Eigenschaften das Datum in verschiedenen Varianten enthalten. Die folgende 
Tabelle zeigt, wie man das Datum in verschiedenen Formaten auslesen kann: 


Tabelle 21. Format-Eigenschaften des Date-Objekts 


Eigenschaft Beispiel 

ShortDate 31.12.99 

LongDate Freitag, 31. Dezember 1999 
AbbreviatedDate Fre, 31. Dez, 1999 


Verschiedene Aspekte des langen und kurzen Datumsformats werden tiber die Systemeinstellungen kontrolliert. Das 
Datumsformat wird auf im Classic Mac OS iiber das Kontrollfeld ,Datum und Uhrzeit“, unter Mac OS X im Datum oder 
Uhrzeit-Karteireiter bei den Landeseinstellungen und unter Windows bei den Landereinstellungen bei Datum und bei 
Uhrzeit eingestellt. Man kann die Reihenfolge von Tag, Monat, Jahr als auch die Trennzeichen konfigurieren. 


Abb. 208: Die Zeit- und Datumsformateinstellungen der verschiedenen Betriebssysteme 


SS threeitfornate Eigenschaften von Landereinstellungen | 2] x| 
Region: Landereinstellungen | Zahlen | Whrung | Uhizeit, Datum | 
Uhr _ Format Waa ; 
— | 
© 24 Stunden Erste Tageshalfte: | Uhr Kalendertyp: uischer Kalender ne 
12 Stunden ‘Wenn eine 2weistellige Jahreszahl eingegeben wird, interpretieren als 
Mittag & Mitternacht: Zweite Tageshalfte: Uhr Jahr zwischen: 
) 0:00 — 11930 und [2023 = 
=a oy Trennzeichen: a 
®) 12:00 
Ofiihrende “o” fiir Stunde ABBEERHET! Kurzes Datum 
Beispiele Regie fur kurzes. 04.05.00 
tum: 
0:34 Uhr 16:56 Uhr 
Kurzes Datumsformat: bd 
"ee Landeseinstellungen =_ Datumstrennzeichen: | 
1 (al & i] k 2 | Langes Datum 
i —_ - ea es 
Alleeinblenden | Monitore Ton Netzwerk Startvolume Bee toes Donnerstag, 4. Mai 2000 
lum: 
f Sprachen Uhrzeit | Zahlen | Tastaturmenii } Langes Datumsformat: |TTTT, T. MMMM Jd | 
Region: _ Deutsch iz] 
g Abbrechen | serene 
Langform = = | Kurzform 
Prafix: | 
Tag.Monat.Jahr By 
Wochentag i] ‘ = 
| Trennzeichen: . 
Tag | 
————t % = 
Monat i) | @ Fihrende ,,0* fur ‘ag 
= | M Fihrende ,0“ fir Monat 
Jahr | w Jahrhundert anzeigen 


© Fihrende ,,0" fir Tag 


Freitag, 8. Marz 2002 
Fr, 8. Mar 2002 
08.03.2002 


Um das Datum in der jeweiligen Formatierung zu erhalten, legt man einfach ein Datumsobjekt an und greift auf die 
jeweilige Eigenschaft zu, die das gewiinschte Format anbietet. In folgendem Beispiel wird das aktuelle Datum, als Long- 
Date formatiert, einer Variable zugewiesen: 

Dim today as New Date 


Dim theDate as String 
theDate=today.LongDate 
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Die TotalSeconds-Eigenschaft eines Date-Objektes ist die Master-Eigenschaft, die Datum und Uhrzeit des Objektes spei- 
chert. Die TotalSeconds-Eigenschaft ist definiert als Anzahl der Sekunden seit dem 1.1.1904. 


Andere Eigenschaftswerte werden von TotalSeconds abgeleitet. Wenn Sie den Wert der Eigenschaft TotalSeconds 
andern, andern sich die Werte der Eigenschaften von Year, Month, Day, Hour, Minute und Second auf die Sekunde, auf 
die TotalSeconds zutrifft. Umgekehrt, wenn Sie eine dieser Eigenschaften dndern, andert sich TotalSeconds ebenfalls 
entsprechend. 


In Windows-Applikationen miissen Sie darauf achten, dass Sie die Day-Eigenschaft nicht auf einen Wert setzen, der gro- 
Ber ist als die Tage des aktuellen Monats. Wenn Sie einen solchen Wert zuweisen mochten, sollten Sie zuerst die 
Day-Eigenschaft auf einen giiltigen Wert ftir einen beliebigen Monat setzen, danach die restlichen Eigenschaften einstel- 
len und als letztes die Day-Eigenschaft einstellen. Eine andere Méglichkeit unter Windows ist, direkt mit der TotalSe- 
conds-Eigenschaft zu arbeiten und dann die zugeh6rigen Werte von Year, Month und Day zu ermitteln. 


Das Format ist von den Einstellungen im Mac OS abhangig. Es kann also auch eine Ausgabe im amerikanischen Format 
erfolgen, je nachdem, wie das System konfiguriert ist. Sie sollten sich dessen bewusst sein, dass die Ausgabe, die Ihr Pro- 
gramm vornimmt, auf einem anderssprachigen System automatisch anders aussieht. 


Zeitangaben 


Zeitangaben werden als Teil eines Datums gespeichert. Datumsobjekte haben zwei Eigenschaften, die die Zeit in unter- 
schiedlichen Formaten liefern. 


Tabelle 22. Format-Eigenschaften des Time-Objekts 


Eigenschaft Beispiel 
ShortTime 17:40 Uhr 
LongTime 17:40:58 Uhr 


Um die aktuelle Uhrzeit in einem dieser Formate zu erhalten, erzeugen Sie zunachst ein Date-Objekt und greifen dann 
auf die jeweilige Eigenschaft zurtick. 

Dim today as Date 

Dim Now as String 

today=new Date 

Now=today.LongTime 

Genau wie bei den Datums-Formaten kann man verschiedene Aspekte des kurzen und des langen Zeit-Formats bei den 
entsprechenden Systemeinstellungen konfigurieren. 


Suchen mit regularen Ausdrucken 


In REALbasic kénnen Sie Text unter Verwendung von regularen Ausdriicken suchen und ersetzen. Reguldre Ausdriicke 
verwenden eine Meta-Sprache in welcher Sie nach speziellen Zeichen, spezifischen Zeichen (z.B. nur Vokale) und ab 
bestimmten Positionen (z.B. am Anfang oder Ende einer Zeile) suchen k6nnen. Sie definieren in dieser Sprache den 
String, nach dem gesucht werden soll und (optional) den String, mit der ersetzt werden soll. 
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Ein reguldrer Ausdruck zum Suchen/Ersetzen wird mit den Eigenschaften der RegEx-Klasse festgelegt. Folgende Tabelle 
listet diese Eigenschaften auf: 


Tabelle 23. Eigenschaften der RegEx-Klasse. 


Name Beschreibung 

Options Diese Optionen sind verschiedene Zustande, die Sie flr die Engine fiir regulare Ausdriicke 
setzen kdnnen. Siehe Tabelle 25. 

ReplacementPattern Dies ist der Ersetze-String, der Uber die bei regularen Ausdrticken Ubliche Standard-Notation 
‘\1' oder '$1' Verweise auf bereits gefundene Substrings beinhalten kann. Dieses Muster wird 
entweder in der Replace-Eigenschaft verwendet oder an die RexExMatch-Klasse Ubergeben, 
wenn Search erfolgt ist und wird spater mit Replace verwendet, wenn keine Parameter 
festgelegt werden. 

SearchPattern Dies ist das Muster, nach dem Sie momentan suchen. 

SearchStartPosition Zeichen-Position, an der Sie die Suche starten wollen, wenn der optionale Parameter 
TargetString zu Replace nicht festgelegt wurde. Beachten Sie, dass, wenn Sie ihn setzen, er 
nur verwendet wird, wenn Sie keinen TargetString festlegen, da das Setzen eines neuen 
TargetString den Wert zurticksetzt. 


Die Methoden der RegEx-Klasse, die in folgender Tabelle aufgelistet sind, werden zum Suchen und Ersetzen verwendet: 


Tabelle 24. Methoden der RegEx-Klasse. 

Name Parameter Beschreibung 

Replace Optional: Findet SearchPattern in Target. Ersetzt den Inhalt von 
TargetString als String; SearchPattern mit ReplacementPattern. Liefert den resultierenden 
SearchStartPosition als String. Replace kann den links angegebenen optionalen Parameter 
Integer erhalten. Liefert einen String zuriick. 

Search TargetString als String; Findet SearchPattern in TargetString und liefert, falls erfolgreich, 
SearchStartPosition als ein RexExMatch. Das RexExMatch merkt sich ReplacementPattern, 
Integer das zum Zeitpunkt der Suche festgelegt wurde. 

Mit der RegExOptions-Klasse kdnnen Sie folgende Optionen festlegen: 


Tabelle 25. Optionen bei den reguliren Ausdriicken. 


Name Beschreibung 

CaseSensitive Legt fest, ob GroB-/Kleinschreibung beim Suchen eines Strings beriicksichtigt werden soll. 
Voreinstellung ist False. 

DotMatchAll Normalerweise findet der Punkt alles auBer einem Zeilenvorschub. Diese Option erlaubt ihm, 
Zeilenvorschiibe zu finden. 

Greedy Greedy bedeutet, dass die Suche alles vom ersten bis zum Ende des letzten Trennzeichen 
und alles dazwischen sucht. Wenn Sie z.B. den folgenden Text mit Bold-Tags in HTML finden 
wollen: 


The <b>quick</b> brown <b>fox</b> jumped 

Wenn Sie dieses Muster verwenden: 

<b>.+</b> 

erhalten Sie bei der Suche "<b>quick</b> brown <b>fox</b>", was nicht das ist, was Sie 
wollten. 

Daher konnen Sie Greedy ausschalten oder diese Syntax verwenden: 

<b>.+?</b> 

und Sie werden "<b>quick</b>" finden, was genau das ist, was Sie wollten.) 
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Tabelle 25. Optionen bei den reguldren Ausdriicken. 


Name Beschreibung 
LineEndType Dies wirkt sich auf die aktuelle Session der regularen Ausdrticke aus) 
Es hat keinen Effekt auf SearchPatterns, wenn TreatTargetAsOnelLine True ist. 
Andert die Art, wie \n fiir ReplacementPatterns expandiert wird 
0 = beliebiges Zeilenende (Mac oder Win32 oder Unix) 
1 = Default fur die Plattform (wenn auf einem Mac, dann 2) 
(wenn unter Win32, dann 3) 
2 = Mac ASCII 13 oder \r 
3 = Win32 ASCII 10 oder \n 
4 = Unix ASCII 10 oder \n 


MatchEmpty Legt fest, ob es Mustern erlaubt ist, leere Strings zu finden. 
ReplaceAllMatches Legt fest, ob jedes Auftreten des Musters ersetzt werden soll. 
StringBeginlsLineBegin Legt fest, ob der Anfang eines Strings als der Anfang einer Zeile zahlt. 
TreatTargetAsOneLine Ignoriert interne Zeilenumbriiche, um '“' und '$' zu finden 


Wenn Sie beim Suchen unter Verwendung von regularen Ausdriicken einen Treffer landen, k6nnen Sie die Eigenschaften 
der RegExMatch-Klasse verwenden, um den passenden String (oder die passenden Strings) zu erhalten und optional das 
Ergebnis mit einem String Ihrer Wahl ersetzen. Die Eigenschaften der RegExMatch-Klasse sind folgende: 


Tabelle 26. Eigenschaften der RexExMatch-Klasse. 


Name Beschreibung 

SubExpressionCount Anzahl der verfligbaren SubExpressions der gerade erfolgten Suche. Die regularen Ausdrticke 
von REALbasic unterstiitzten sowohl \number als auch $number fiir SubExpressions. 
SubExpressions erlauben das Ersetzen von Teilen des Musters (Pattern). 

SubExpressionString Liefert SubExpression als einen String ftir die angegebene matchNumber. 0 liefert den 
gesamten MatchString (das implizierte Ote subExpression) und 1 ist die erste echte 
subExpression. 

SubExpressionStart Liefert die Startposition von der durch matchNumber festgelegten subExpression. 

Replace Ersetzt das gefundene Ergebnis in der Weise, die durch ReplacementPattern festgelegt wird. 
Wenn kein Rep/acementPattern festgelegt ist, verwendet es das ReplacementPattern, das im 
RegEx-Objekt zur Zeit der Suche festgelegt wurde. 


Weitere Informationen finden Sie in der Sprachreferenz. 
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Das Koordinatensystem 


Bei den meisten grafischen Methoden muss man angeben, an welcher Stelle innerhalb des Canvas-Steuerelements 
gezeichnet werden soll. Diese Angabe macht man bezogen auf das Koordinatensystem, das man sich als unsichtbares 
Gitter aus horizontalen und vertikalen Linien mit einem Pixel Abstand vorstellen kann. Wenn Sie Koordinatensysteme 
nur aus der Mathematik kennen, dann erwarten Sie den Ursprung (0,0) vielleicht in der Mitte des Fensters. Das ware 
allerdings sehr unpraktisch, daher liegt der Ursprung immer in der linken oberen Ecke der Zeichenflache. Der Ursprung 
des gesamten Bildschirms ist die linke obere Ecke des Bildschirms. Bei einem Fenster ist dies dessen linke obere Ecke 
und fiir ein Steuerelement ist es wiederum dessen linke obere Ecke. Die Werte auf der X-Achse (Horizontalachse) erho- 
hen sich von links nach rechts und auf der Y-Achse (Vertikalachse) werden sie von oben nach unten gréfer. 
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Ein Punkt innerhalb eines Fensters mit den Koordinaten 10,20 befindet sich also 10 Punkte rechts vom linken Rand und 
20 Punkte unter dem oberen Rand. Wenn Sie innerhalb eines Canvas-Steuerelements arbeiten, befindet sich der Punkt 
10,20 von der linken Kante des Steuerelements 10 Pixel und von der oberen Kante 20 Pixel entfernt. 


Abb. 209: Das X,Y-Koordinatensystem 


X-Achse. ——ARA > 


ese 5 SS Namenlos S18 


0,0 (Fensterkoordinaten) 


0,0 (Canvas-Steuerelement-Koordinaten) 


Darstellen von Bildern in einem Fenster 


Benutzen des gesamten Fensters zur Darstellung 


Wenn Sie ein Bild in einem Fenster darstellen wollen, dann k6nnen Sie dazu die Backdrop-Eigenschaft des Fensters ver- 
wenden. Hier kann ein Bild abgelegt werden, das dann im Fenster angezeigt wird und das auch automatisch hinter even- 
tuell im Fenster platzierten Steuerelementen liegt. Die Eigenschaft Backdrop hat normalerweise den Wert ,kein“ (None). 
Es gibt mehrere Méglichkeiten, ein Bild der BackDrop-Eigenschaft eines Fensters zuzuweisen. Auf dem Macintosh ist der 
einfachste Weg, die Bild-Datei aus dem Finder in das Fenster in der Entwicklungsumgebung zu ziehen. Wenn Sie das 
machen, passieren mehrere Dinge: Das Bild erscheint im Fenster in der Entwicklungsumgebung, der Name der Bilddatei 
wird dem Projekt hinzugeftigt und es wird der BackDrop-Eigenschaft im Eigenschaftenfenster des Fensters zugewiesen. 


Sie konnen ein Bild auch der BackDrop-Eigenschaft eines Fensters zuweisen, indem Sie die Bild-Datei in Ihr Projektfens- 
ter zichen und denn den Namen des Bildes als BackDrop-Eigenschaft im Eigenschaftenfenster auswahlen. In einem 
Open-Event-Handler eines Fensters konnen Sie z.B. schreiben: Backdrop=Bildname, wobei Bildname der Name des 
Bildes ist, wie er im Projektfenster erscheint. 


Zusatzlich konnen Sie zur Laufzeit die BackDrop-Eigenschaft setzen, indem Sie ein Bild laden oder mit den Methoden 
der Graphics-Klasse neu zeichnen. Folgendes Beispiel zeigt, wie der Benutzer mit einer ganz normalen Dateiauswahlbox 
PICT, JPEG oder GIF-Dateien wahlen kann, die dann als Backdrop-Bild im Fenster angezeigt werden: 
Dim f as FolderItem 
f=GetOpenFolderItem( "image/gif; image/jpeg; image/x-pict") 
If f<> Nil Then 

Backdrop=f .OpenAsPicture 
End If 
Achtung: Dieses Beispielprogramm funktioniert nur dann, wenn Sie die Dateitypen image/gif, image/jpeg und image/ 
x-pict in der Dialogbox Bearbeiten/Dateitypen definiert haben. 
Nachdem Sie der BackDrop-Eigenschaft ein Bild zugewiesen haben, k6nnen Sie die Grde des Fensters automatisch an 
die Grdfe des Bildes anpassen, indem Sie den Eigenschaften Height (HGhe) und Width (Breite) des Fensters jeweils die 
Eigenschaften Height (Hohe) und Width (Breite) des Bildes zuweisen: 
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width=Backdrop.width 
height=Backdrop.height 


Das Neuzeichnen des Backdrop-Bildes iibernimmt REALbasic automatisch. 


Darstellung in einem Teilbereich des Fensters 


Wenn Sie das Bild nur in einem Teilbereich des Fensters anzeigen wollen, k6nnen Sie ein ImageWell-Steuerelement ver- 
wenden. Ein ImageWell ist einem Canvas-Steuerelement sehr ahnlich, aufser dass es keine Zeichenwerkzeuge besitzt: Sie 
konnen nur ein Bild darstellen, das schon an anderer Stelle erzeugt wurde. 


Um ein Bild der Image-Eigenschaft eines ImageWells zuzuweisen, draggen Sie es einfach aus dem Finder in das Projekt- 
fenster und weisen es dann der Image-Eigenschaft des ImageWell unter Verwendung seines Eigenschaftenfensters zu. 


Sie konnen zur Laufzeit ein Bild hinzuftigen, indem Sie es mittels Code laden. Folgendes Code-Beispiel zeigt eine Datei- 
auswahlbox an, die die Auswahl einer PICT-, JPEG-, oder GIF-Datei erlaubt und zeigt diese dann im ImageWell an. Vor- 
aussetzung ist, dass die als Parameter fiir die Dateiauswahlbox verwendeten Dateitypen in Ihrem Projekt unter 
Bearbeiten/Dateitypen definiert wurden. 
dim f as FolderItem 
f=GetOpenFolderItem("image/x-pict; image/jpeg; image/gif") 
if f <> Nil then 

ImageWel11.Image=f .OpenAsPicture 
end if 
Sie konnen dem Anwender auch erlauben, ein Bild-Dokument aus dem Finder auf ein ImageWell zu draggen, ohne dass 
die Dateiauswahlbox verwendet wird. Im Open-Event-Handler des ImageWells erlauben Sie das Droppen einer Datei mit 
folgenden Zeilen: 


me.acceptfileDrop("image/x-pict") 
me.acceptfileDrop("image/ jpeg") 


me.acceptfileDrop("image/gif") 


Im DropObject-Event-Handler des ImageWells wird folgender Code verwendet: 


Sub (DropObject (Obj as DragItem) 
If Obj.FolderItemAvailable then 
Me. Image=0bj.FolderItem.OpenAsPicture 
End if 
End Sub 
Hinweis: Dieser Code unterstiitzt nur PICT-Dateien (Mac) und .BMP-Dateien (Windows), so lange kein QuickTime auf 
dem Rechner installiert wurde. 


Die andere Moglichkeit ist, ein Canvas-Steuerelement zu verwenden, um ein Bild in einem Teilbereich des Fensters anzu- 
zeigen. Dieses Steuerelement stellt eine Zeichenflache zur Verftigung, in der Sie Zeichenoperationen ausfiihren k6nnen, 
die aber auch Events entgegennimmt. Daher k6nnen Sie ein Canvas-Steuerelement auch verwenden, um dem Benutzer 
eine Interaktion zu gestatten. Mit der Backdrop-Eigenschaft des Canvas-Steuerelements kénnen Sie ein vorhandenes 
Bild anzeigen. Wie beim Fenster schon gezeigt, kann das manuell in der Entwicklungsumgebung geschehen oder mittels 
Laden eines Bildes und Zuweisen an die Backdrop-Eigenschaft. Hier ein Beispiel analog zu dem obigen: 
Dim f as FolderItem 
f=GetOpenFolderItem("image/x-pict") 
If f<> Nil Then 

Me.Backdrop=f .OpenAsPicture 
End If 
Sie konnen Drag&Drop auf ein Canvas-Steuerelement in der gleichen Weise wie fiir ein ImageWell realisieren. Der Vorteil 
bei der Verwendung eines Canvas-Steuerelements ist, dass Sie das Bild mit den Methoden der Graphics-Klasse unter Ver- 
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wendung des Paint-Event-Handlers des Canvas-Steuerelements verdindern kénnen. Dies wird im folgenden Abschnitt 
beschrieben. 


Zeichnen von Bildern 


Sie kénnen in Ihrem Programm Bilder mit den Methoden der Graphics-Klasse zeichnen. Ein Graphics-Objekt ist ein 
Objekt im Speicher, das ein Bild enthdlt. Die Objekte Window und Canvas haben ein Paint-Event. Dieses wird immer 
dann ausgeftihrt, wenn das Window- oder Canvas-Objekt neu gezeichnet werden muss. Wird beispielsweise ein Fenster 
gedffnet, dann wird das Paint-Event aktiv, denn der Inhalt des Fenster muss gezeichnet werden. Jedes Canvas-Element 
im Fenster wird ebenfalls ein Paint-Event ausfiihren, da das Canvas-Objekt Bestandteil des zu zeichnenden Fensters sind. 
Diese Events werden auch dann ausgefiihrt, wenn ein Teil des Fensters verdeckt war und nun gezeichnet werden muss, 
weil ein anderes Fenster verschoben wurde. 


Das Paint-Event erhalt ein Graphics-Objekt als Parameter. Bei Beendigung des Paint-Events wird dieses Objekt im Win- 
dow- oder Canvas-Objekt gezeichnet. Im Window- oder Canvas-Objekt zeichnen Sie mittels der Zeichen-Methoden des 
jeweiligen Graphic-Objekts. 


Anzeigen von Bildern 


Bilder werden in Graphics-Objekten mittels der DrawPicture-Methode der Graphics-Klasse gezeichnet. Dieser Methode 
wird das zu zeichnende Bild tibergeben und die Koordinaten, an denen es innerhalb des Graphics-Objekts ausgegeben 
werden soll. Im folgenden Beispiel werden mit dem Paint-Event zwei Bilder (BartPict und LisaPict) nebeneinander 
gezeichnet. Die beiden Bilder miissen dazu zuvor in Ihr Projektfenster gezogen werden: 
Sub Paint(g As Graphics) 

g.DrawPicture BartPict, 0,0 


g.DrawPicture LisaPict,BartPict.Width, 0 
End Sub 


Kopieren von Bildteilen 


Ausschnitte von Bildern lassen sich mit der DrawPicture Methode aus der Graphics-Klasse in ein Graphics-Objekt kopie- 
ren. Dies erreicht man mit optionalen Parametern der DrawPicture-Methode, mit denen ein Teilbereich eines Bildes, der 
gezeichnet werden soll, definiert werden kann. Man kann die Ausgangskoordinaten sowie die Hohe und Breite des Teil- 
bereiches angeben. 


Im folgenden Beispiel wird ein Bereich von 20 mal 20 Pixeln des Quellbildes gezeichnet, der zehn Pixel vom linken Rand 
und zehn Pixel vom oberen Rand entfernt beginnt. Der Ausschnitt wird dann fiinf Pixel vom linken Rand und fiinf Pixel 
vom oberen Rand entfernt in das Canvas- oder Window-Objekt gezeichnet: 

Sub Paint(g As Graphics) 


g.DrawPicture Lisa,5,5,Lisa.width,Lisa.height,10,10,20,20 
End Sub 


Skalieren von Bildern 


Die Methode DrawPicture der Graphics-Klasse erlaubt auch die Skalierung von Bildern. Dazu miissen alle DrawPic- 
ture-Parameter angegeben werden. Die Skalierung erfolgt einfach dadurch, dass fiir das auszugebende Bild eine Breite 
oder Héhe angegeben wird, die von der Originalbreite oder -hdhe abweicht. Im Beispiel wird das Bild doppelt so grof 
ausgegeben, wie es im Original ist: 

Sub Paint(g As Graphics) 

Dim w,l] as integer 

w=lisa.width 

l=lisa. height 

g.DrawPicture lisa, 0,0,w*2,1*2,0,0,lisa.width, lisa.height 

End Sub 
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Es folgt ein Beispiel, das ein importiertes Bild automatisch auf die Grofe eines Canvas-Steuerelements skaliert. 


Angenommen, Sie haben ein Fenster mit einem Canvas-Steuerelement und einem PushButton (oder einem anderen 
Steuerelement), der den Code fiir das Importieren und das Skalieren auslést. 


Deklarieren Sie eine Variable fiir das Elternfenster, die das skalierte Bild enthilt: 


Fensterl Quellcode 


Deklaration: | pis As Picture| 


Giltigkeitsbereich: | Geschitzt (Fenster1 und Unterklassen) iE 


—) Im Eigenschaftenfenster anzeigen 


Abbrechen_) (95) OKu 


Im ActionEvent des Push-Buttons verwenden Sie den folgenden Code, um das Bild zu importieren und zu skalieren: 


Dim f As FolderItem 

Dim p As Picture 

Dim maxWidth, maxHeight As Integer 
Dim factor As Double 


maxWidth = Canvasl.width 
maxHeight = Canvasl.height 


f = GetOpenFolderItem("PICT") 
If f <> nil then 

p = f.OpenAsPicture 

end if 


factor = Min( maxWidth / p.Width, maxHeight / p.Height ) 
factor = Min( factor, 1.0 ) // (nicht skalieren, wenn es zu klein ist!) 


pic = NewPicture( p.Width * factor, p.Height * factor, 32 ) 
pic.graphics.DrawPicture p, 0,0,pic.width,pic.height, 0,0,p.width,p.height 


Canvasl.Refresh 

(Dieses Codebeispiel geht davon aus, dass Sie eine PICT-Datei importieren mochten und dass Sie den Dateityp PICT in 
der Dateitypen-Dialogbox definiert haben). 

Die Werte von maxWidth und maxHeight entsprechen in diesem Beispiel der Grofse des Canvas-Steuerelementes. Sie 
konnen natiirlich auch andere Werte nehmen. Die DrawPicture-Methode der Graphics-Klasse verwendet die folgenden 


Parameter: 
Table 27: 
Parameter Typ Beschreibung 
Image Picture Das zu zeichnende Bild an der durch X und Y angegebenen Position. 
Xx Integer X-Koordinate innerhalb des Steuerelements der linken Bildseite. Voreinstellung ist null. 
Y Integer Y-Koordinate innerhalb des Steuerelementes der oberen Bildbegrenzung.Voreinstellung ist 
null. 
DestWidth Integer Breite des Bildes im Steuerelement. 
DestHeight Integer Hohe des Bildes im Steuerelement. 
Sourcex Integer X-Koordinate des Bildes, das Sie kopieren. Voreinstellung ist null 


SourceY Integer Y-Koordinate des Bildes, das Sie kopieren. Voreinstellung ist null. 
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Table 27: 


Parameter Typ Beschreibung 
SourceWidth — Integer Breite des Bildes, das Sie kopieren mochten. Voreinstellung ist die Breite des Bildes. 
SourceHeight — Integer Hdhe des Bildes, das Sie kopieren mdchten. Voreinstellung ist die Hohe des Bildes. 
Zum Abschluss miissen Sie zum PaintEvent des Canvas-Steuerelements den Code hinzuftigen, der der Backdrop-Eigen- 
schaft des Canvas-Steuerelements das skalierte Bild ,,pic‘ zuweist. 


If pic <>Nil then 
g.DrawPicture pic,0,0 
End if 


Standard-Piktogramme in Dialogen 


Die MsgBox-Funktion von REALbasic zeichnet normalerweise einfach ein Sprechblasen-Icon und einen OK-Knopf in 
eine Messagebox. Das Sprechblasen-Icon ist aber nicht ganz passend, wenn der Benutzer gewarnt werden soll. Ist der 
Benutzer im Begriff etwas zu tun, das mit dem Verlust von Daten enden kénnte (wie beispielsweise das Verlassen des 
Programms ohne vorheriges Sichern), sollte das Warn-Icon angezeigt werden. Das Stop-Icon verwendet man, wenn der 
Benutzer etwas machen will, das gerade nicht geht, wie etwa das Speichern des Dokuments auf einem schreibgeschiitz- 
ten Medium. 


Abb. 210: Sprechblasen-, Warn- und Stop-Icons unter Windows XP und Mac OS X 
° 
bao 


Hinweis: Unter Mac OS Classic kann das Aussehen dieser drei Icons je nach Einstellung im Erscheinungsbild-Kontroll- 
feld variieren. Unter Windows konnen diese Icons je nach Desktopdarstellung unterschiedlich aussehen. 


Die Graphics-Klasse bietet dazu die Methoden DrawNotelcon, DrawCautionIcon und DrawStopIcon, mit denen diese 
Icons einfach in einem Canvas- oder Windows-Objekt angezeigt werden konnen. Man sollte diese Methoden verwenden, 
da die Icons von einer Version des Betriebssystems zur nachsten wechseln konnen und auch auf einer anderen Betriebs- 
systemplattform anders aussehen. So wird immer das Icon gezeigt, das zum System passt. 


So wird im Paint-Event eines Canvas-Objekts ein Sprechblasen-Icon gezeichnet: 


Sub Paint(g As Graphics) 
g.DrawNoteIcon 0,0 
End Sub 


Pixel zeichnen 


Mit der Pixel-Eigenschaft konnen Sie die Farbe eines beliebigen Punktes in einem Graphics-Objekt setzen oder auslesen. 
Dazu geben Sie die Koordinaten des Pixels an und setzen oder lesen die Farbe. 


Das Beispiel zeichnet Pixel an zufallig gewahlten Koordinaten mit zufalligen Farben in einem Graphics-Objekt, bis der 
Benutzer die ESC-Taste oder -,,.“ (Macintosh) driickt: 


Sub Paint(g As Graphics) 

Dim c as Color 

Do 

c=Rgb(Rnd*255, Rnd*255, Rnd*255) 
g.Pixel (Rnd*me.Width, Rnd*me.Hei ght )=c 
Loop until UserCancelled 

End Sub 
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un ein Beispiel, wie man die Farbe des Pixels unter der Mausspitze tiber einem Canvas-Objekt ausliest und diese auf ein 
nderes Canvas-Objekt (namens PixelColor) tibertrigt: 


n 2 


ub MouseMove(X As Integer, Y As Integer) 

Dim c as Color 

c=Me.Graphics.Pixel (X,Y) 

PixelColor.Graphics.ForeColor=c 

PixelColor.Graphics.FillRect 0,0,PixelColor.Width,PixelColor.Height 
End Sub 


Zeichnen von Linien 


Linien werden mit der DrawLine-Methode aus der Graphics-Klasse gezeichnet. Die Farbe der Linie ist in der Eigenschaft 
ForeColor des Graphics-Objekts gespeichert, in dem gezeichnet wird. Zum Zeichnen der Linie muss man der Methode 
die Anfangs- und die Endkoordinaten der Linie tibergeben. 


Dieses Beispiel zeichnet ein Gitter innerhalb eines Canvas-Objekts oder in einem Fenster. Die Groe jedes Kastchens 
wird durch die Variable boxSize vorgegeben: 


Sub Paint(g as Graphics) 

Dim i, boxSize as Integer 

boxSize=10 

For i=boxSize to Me.Width Step boxSize 
g.DrawLine 1,0,i1,Me.Height 

ext 

For i=boxSize to Me.Height Step boxSize 
g.DrawLine 0,i1,Me.Width, i 

ext 

End Sub 


Die Starke der Linie wird durch die Eigenschaften PenHeight und PenWidth des Graphics-Objekts vorgegeben. 


Zeichnen von Ovalen 


Mit DrawOval und FillOval bietet die Graphics-Klasse Methoden zum Zeichnen von Ovalen. Fiir beide sind die gleichen 
Parameter erforderlich, namlich die X/Y-Koordinaten, an denen das Oval gezeichnet werden soll und die Breite und 
Hohe. Beide Methoden zeichnen ein Oval in der ForeColor-Farbe des Graphics-Objekts in der Linienstirke, die in Pen- 
Width und PenHeight vorgegeben sind. DrawOval zeichnet die Rander des Ovals, wahrend FillOval die Flache des Ovals 
zusatzlich mit der ForeColor fiillt. 


So wird ein Oval in ein Canvas- oder Window-Objekt gezeichnet: 


Sub Paint(g as Graphics) 
g.Draw0val 0,0,50,75 
End Sub 


Zeichnen von Rechtecken 


Rechtecke werden mit den Methoden DrawRect, FillRect, DrawRoundRect und FillRoundRect der Graphics-Klasse 
gezeichnet. Diese Methoden benotigen alle die linke obere Ecke des zu zeichnenden Rechtecks als X/Y-Koordinate und 
seine Breite und Hohe. ForeColor, PenWidth und PenHeight geben Farbe und Linienstirke an. 


RoundRectangles sind Rechtecke mit gerundeten Ecken. Daher wird ftir DrawRoundRect und FillRoundRect noch eine 
Angabe zur Breite und HGhe der Rundung in den Ecken des Rechtecks bendotigt. 


DrawRect und DrawRoundRect zeichnen die Begrenzungslinien der Rechtecke, wahrend FillRect und FillRoundRect 
gefiillte Rechtecke zeichnen. 
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Zeichnen von Polygonen 


Polygone werden mit den Funktionen DrawPolygon und FillPolygon der Graphics-Klasse gezeichnet. Dazu wird ein Array 
iibergeben, das jeden Punkt des Polygons enthalt. Das Array beginnt mit dem Element 1. Elemente mit ungeraden Num- 
mern enthalten die X-Koordinate, wahrend Elemente mit geraden Nummern die Y-Koordinate enthalten. Das bedeutet, 
dass Element 1 die X-Koordinate des ersten Polygonpunkts und Element 2 seine Y-Koordinate enthalt. Nehmen wir fol- 
gendes Array an: 


Tabelle 28. Ein Array mit Werten fiir ein Polygon 


Element Nr. Wert 


] 10 
2 5 
5 40 
4 40 
S, 2) 
6 60 


Wird dieses Array an die DrawPolygon oder FillPolygon-Methode tibergeben werden folgende Linien gezeichnet: Von 
10,5 nach 40,40, dann von 40,40 nach 5,60 und von 5,60 zuriick zu 10,5. Da dieses Polygon nur drei Koordinatenpaare 
enthalt, entsteht ein Dreieck: 


Der dazugehorende Code fiir ein Paint-Event sieht so aus: 


Sub Paint(g As Graphics) 
Dim points(6) as Integer 
points(1)=10 
points(2)=5 
points(3)=40 
points (4)=40 
points(5)=5 
points (6)=60 
g.DrawPolygon points 

End Sub 


FillPolygon zeichnet dasselbe Polygon, allerdings mit geftilltem Innenraum: 


Eigene Steuerelemente mit einem Canvas-Objekt realisieren 

Steuerelemente, die wie PushButtons ein grafisches Interface verwenden, mit dem der Anwender interagieren kann, 
sind nichts anderes als Bilder, die mit einem entsprechenden Unterprogramm gezeichnet werden. Daher kann man mit 
einem Canvas-Objekt sehr leicht Steuerelemente entwerfen, die nicht in REALbasic eingebaut sind. 

Angenommen, Sie mochten ein sehr simples Steuerelement zeichnen, das einfach aus einem Rechteck besteht, dessen 
Farbe von Schwarz nach Weifs wechselt, wenn man es anklickt. Da das Rechteck seine Farbe jeweils wechseln soll, wenn 
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der Benutzer es anklickt, gehort der Code dazu in den MouseDown-Event-Handler des Canvas-Objekts. Das Programm 
muss priifen, ob das Rechteck weifs ist und es dann schwarz einfarben oder im umgekehrten Fall weifs. Dazu muss man 
nur die Farbe eines beliebigen Pixels in dem Objekt priifen, woftir die Reb-Funktion verwendet wird. Ubergibt man die- 
ser eine 0 fiir alle Parameter, dann ergibt das die Farbe wei. Schwarz resultiert aus dem Ubergeben von 255 fiir alle Para- 
meter. Spater werden Sie noch mehr tiber Farben erfahren. Fiir den MouseDown-Handler verwendet man folgendes 
Programm: 
Function MouseDown(X As Integer, Y As Integer) As Boolean 

If Me.Graphics.Pixel(X,Y)=Rgb(0,0,0) Then 

Me.Graphics.ForeColor=Rgb(255, 255,255) 

Else 

Me.Graphics.ForeColor=Rgb(0,0,0) 

End If 

Me.Graphics.FillRect Me.Left,Me.Top,Me.Width,Me.Height 
End Function 
Es wird tiberpriift, ob das Pixel, auf den der Benutzer geklickt hat, weif ist. Ist dies der Fall, dann wird die ForeCo- 
lor-Eigenschaft des Canvas-Objekts, das allgemeingiiltig durch die Me-Funktion reprasentiert wird, auf schwarz gesetzt 
und andernfalls auf weifs. Danach wird die Methode FillRect fiir das Canvas-Objekt aufgerufen, um es mit der ForeColor 
zu fiillen. 


Das Steuerelement ist noch nicht ganz fertig. Wenn es neu gezeichnet werden muss (zum Beispiel beim ersten Offnen 
des Fensters) wird das Paint-Event aufgerufen. Da hier kein Code vorhanden ist, wird das Element auch nicht gezeich- 
net. Daher muss eine leicht modifizierte Variante der Routine, die fiir den MouseDown-Handler verwendet wurde, ein- 
gesetzt werden: 

Sub Paint(g As Graphics) 


If g.Pixel(0,0)=Rgb(0,0,0) Then 
g.ForeColor=Rgb(255, 255,255) 


Else 

g.ForeColor=Rgb(0,0,0) 

End If 

g.FillRect Me.Left,Me.Top,Me.Width,Me.Height 
End Sub 


Da der Paint-Event-Handler mittels des Parameters g eine Referenz auf das Canvas-Objekt bekommt, kann man den 
Code etwas allgemeingiiltiger fassen und ,,g“ statt ,me.graphics“ verwenden. Da der Benutzer in diesem Fall nirgends 
klickt, muss ein Pixel angegeben werden, dessen Farbe gepriift wird. Wir haben im Beispiel das Pixel 0,0 gewahlt. 


Im Wiederverwendbare Objekte durch Klassen“ auf Seite 304 werden Sie erfahren, wie man erheblich komplexere Steu- 
erelemente mittels Klassen definieren kann. 


Das Arbeiten mit Vektorgrafiken 


Die REALbasic-Programmiersprache umfasst eine Reihe von Klassen, die Ihnen das Erzeugen, Offnen und Sichern von 
Vektorgrafiken ermoglichen. Eine Vektorgrafik ist (im Gegensatz zur Bitmapgrafik) vollstandig aus primitiven Objekten — 
Linien, Rechtecken, Text, Kreisen und Ovalen usw. — zusammengesetzt, die ihre Identitat in der Grafik beibehalten. Sie 
ldsen sich nicht auf und werden nicht Teil einer undifferenzierbaren Bitmap. Die Object2D-Klasse ist die Basisklasse fiir 
alle Klassen, mit denen sich primitive Objekte erzeugen lassen. Sie sind in der folgenden Tabelle aufgelistet: 


Tabelle 29. Klassen zum Zeichnen von Vektorgrafiken 


Klasse Beschreibung 
ArcShape Zeichnet den Bogen eines Kreises. 
CurveShape Zeichnet gerade Linien oder Kurven unter Verwendung von einem oder mehreren Ankerpunkten. 


FigureShape Zeichnet Polygone, die (optional) gekriimmte Seiten enthalten konnen. 
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Tabelle 29. Klassen zum Zeichnen von Vektorgrafiken 


Klasse Beschreibung 

OvalShape Zeichnet Kreise und Ovale. 

PixMapShape Importiert eine Bitmapgrafik in die Vektorzeichnung. 
RectShape Zeichnet Quadrate oder Rechtecke. 


RoundRectShape Zeichnet Quadrate oder Rechtecke mit abgerundeten Kanten (Unterklasse der RectShape-Klasse). 


StringShape Zeichnet String-Text gemaB Font, FontgrdBe und Stil. 


Da jede der in der obigen Tabelle abgebildeten Klassen sich von der Objekt2D-Klasse ableitet, konnen Sie die Eigen- 
schaften der Objekt2D-Klasse dazu verwenden, das Objekt zu zeichnen. Sie werden in der folgenden Tabelle aufgelistet: 


Tabelle 30. Eigenschaften der Objekt2D-Klasse 


Name Beschreibung 

Border Starke der Umrandung, reicht von 0 (transparent) bis 100 (undurchsichtig). Voreinstellung ist 0. 
BorderColor Farbe der Umrandung. 

BorderWidth — Die Breite der Umrandung in Punkten. Die Voreinstellung betragt 1. 


Fill Die Farbdichte des eingeschlossenen Teils, reicht von 0 (transparent) bis 100 (undurchsichtig). 
Voreingestellt ist 100. 

FillColor die Fillfarbe einer Vektorform. 

Rotation Rotation im Uhrzeigersinn, im BogenmaB, um den Punkt X,Y. 

Scale Skalierungsfaktor relativ zur OriginalgréBe des Objekts. 

x Horizontale Position des Zentrums oder des Hauptankerpunktes. 

Y Vertikale Position (ausgehend von der top-Eigenschaft nach unten) des Zentrums oder des 
Hauptankerpunktes. 


Jede Klasse besitzt weitere Eigenschaften, die die individuelle Form oder die Eigenschaften des jeweiligen Objekts 
betreffen. Die RectShape-Klasse beispielsweise besitzt Eigenschaften fiir die Hhe und Breite des Rechtecks. Die Round- 
RectShape-Klasse besitzt zusatzliche Eigenschaften, die die Hohe und Breite der Kantenabrundungen sowie die Anzahl 
der verwendeten geraden Linien fiir die abgerundeten Ecken genauer festlegen. Weitere Informationen zu den einzel- 
nen Eigenschaften finden Sie in der Sprachreferenz. 


Vektorobjekte zeichnen und anzeigen 


Sie zeichnen ein Vektorobjekt, indem Sie es ganz einfach instanziieren und seine Eigenschaften festlegen. Der folgende 
Code zeichnet ein RoundRectShape: 


Dim r as RoundRectShape 

r=New RoundRectShape 

-width=120 

-height=120 

.border=100 
.bordercolor=RGB(0,0,0)//schwarze Umrandung 
.fil]lcolor=RGB(255,102,102) 
.cornerHeight=15 

.cornerWidth=15 

.borderwidth=2.5 


s 


Py Ses, BS Sy 


Das einzige Problem“ mit dieser Vektorform ist, dass diese nirgendwo auftaucht. Sie ist lediglich definiert und bereit 
zum Gebrauch. Sie miissen noch einen Befehl hinzufiigen, der das Vektor-Objekt in einem anderen Objekt, also einem 
Fenster oder ein Steuerelement, das Grafik darstellen kann (z.B. Canvas), anzeigt. 
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Im Paint-Event eines Steuerelements oder Fensters ist der Code zum Darstellen von Vektor-Objekten gut aufgehoben. 
Dem Paint-Event-Handler wird ein Graphics-Objekt tibergeben und Sie miissen lediglich die DrawObject-Methode der 
Graphics-Klasse aufrufen, um das Objekt darzustellen. Der Zugriff auf die Graphics-Klasse erfolgt tiber den Parameter g. 
Die DrawObject-Methode akzeptiert drei Parameter. Das darzustellende Objekt und die X- und Y-Position, an der es 
gezeichnet werden soll. 


Der folgende Code zeichnet ein fertiges Vektor-Objekt in einem Fenster. 


Dim r as New RoundRectShape 

.width=120 

-height=120 

.border=100 

.bordercolor=RGB(0,0,0) //black border 
.fi11color=RGB(255,102,102) 
.cornerHeight=15 

.cornerWidth=15 

.borderwidth=2.5 

g.DrawObject r,100,100 //draw at 100,100 


Vektor-Objekte konnen aus mehreren einzelnen Vektor-Objekten zusammengesetzt werden. Dieses zusammengesetzte 
Objekt ist dann ein Group2D-Objekt. Wenn Sie mit der Zusammenstellung fertig sind, kGnnen Sie das Objekt tiber die 
DrawObject-Methode darstellen. 


Der folgende Code zeigt, wie so etwas aussehen kann. Wir haben dem letzten Beispiel ein weiteres RoundedRect- 
Shape-Objekt hinzugeftigt und es um 20 Pixel nach rechts und unten verschoben. Die zwei Append-Anweisungen erzeu- 
gen das Group2D-Objekt. 

Dim r as New RoundRectShape 


Dim s as New RoundRectShape 
Dim group as New Group2D 


.width=120 

.height=120 

.border=100 

.bordercolor=RGB(0,0,0) // Schwarzer Rahmen 
.f111color=RGB( 255,102,102) 
.cornerHeight=15 

.cornerWidth=15 


i 
r 
r 
cr 
r 
r 
r 
r. borderwidth=2.5 


.border=100 

.bordercolor=RGB(0,0,0) // Schwarzer Rahmen 
.f111color=RGB(255,102,102) 
.cornerHeight=15 

.cornerWidth=15 

.borderWidth=2.5 


NnNnnnnnnn 


s.x=r.xt20 // s um 20 Pixel nach rechts verschieben 
s.y=r.yt+20 // s um 20 Pixel nach unten verschieben 


group.append r 
group.append s 
g.drawObject group,100,100 


Wenn Sie einer Bitmapgrafik eine Vektorgrafik hinzuftigen wollen, konnen Sie dies ebenfalls, indem Sie beide iiber die 
Append-Methode zu einem Group2D-Objekt zusammenfiigen. 
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In dem folgenden Beispiel werden ein StringShape- und ein PixmapShape-Objekt zu einem Group2D-Objekt zusam- 
mengefiigt. Die Grafik h1 wurde zuvor in das Projektfenster gezogen. 

Dim px As PixmapShape 

Dim s As StringShape 

Dim d As New Group2D 


px=New PixmapShape(hl) //hl ist eine Grafik im Projektfenster 
d.append px 


s=New StringShape 

s.y=/0 

s.Text="Das ist es, was ich ein ECHTES Auto nenne!” 
s.TextFont="Helvetica” 

s.Bold=true 

d.append s 

graphics.drawobject d,100,100 


Offnen und Abspeichern von Vektorgrafiken 


Zwei Methoden der Folderltem-Klasse sind fiir die Verwendung mit Vektorgrafiken von Bedeutung: OpenAsVectorPic- 
ture und SaveAsPicture. Die OpenAsVectorPicture-Methode Gffnet eine Pict-Datei (Macintosh) oder eine .emf-Datei 
(Windows) und versucht, die Objekte in der Pict-Datei in ftir die Group2D-Klasse von REALbasic verwertbare Objekte 
umzuwandeln. Die Originaldatei enthalt mdglicherweise Elemente, fiir die es keine Entsprechung in REALbasic gibt. Die 
OpenAsVectorPicture-Methode versucht das bestmégliche Ergebnis ftir derlei Objekte zu erzielen. 


Die SaveAsPicture-Methode besitzt einen optionalen Parameter, der das Format der abgespeicherten Datei festlegt. Még- 
lich sind das Pict-Format (Macintosh) oder die .emf- und .bmp-Formate (Windows). Die Informationen der Vektorgrafik 
gehen dabei nicht verloren. Weitere Informationen finden Sie in der Sprachreferenz. 


Der Umgang mit Farben 


REALbasic behandelt Farben als Datentypen. Eine Farbe wird durch drei Farbwerte definiert. Eine Farbe kann spezifiziert 
werden, indem man eines der Farbmodelle RGB, HSV oder CMY verwendet. Um die Farbe festzulegen, verwenden Sie 
die jeweils relevanten drei Farb-Eigenschaften. Wenn Sie z.B. das RGB-Model benutzen, verwenden Sie die RGB-Funk- 
tion, um die Werte ftir die Eigenschaften Rot, Griin und Blau festzulegen. Die Anteile konnen einen Wert von 0 bis 255 
annehmen. Einige Klassen haben Color-Eigenschaften. Beispielsweise ist die ForeColor-Eigenschaft der Graphics-Klasse 
eine solche Color-Eigenschaft. 

Soll eine Farbe gespeichert werden, erzeugen Sie eine Eigenschaft oder Variable vom Typ Color und weisen dieser mit 
der RGB-, HSV- oder CMY-Funktion einen Wert zu. Im Beispiel wird eine neue Variable vom Typ Color angelegt und die 
Werte fiir die Farbe Weifs werden tiber die Reb-Funktion zugewiesen: 


Dim c as Color 
c=Rgb(255, 255,255) 


Sie konnen auch auf direktem Wege und ohne die RGB-, HSV- oder CMY- Funktionen einen Farbwert zuweisen. Um 
einen Farbwert zu definieren, verwenden Sie das RGB-Model mit der folgenden Syntax: 

&CRRGGBB 

RR ist der Hexadezimal-Wert ftir Rot, GG der Hexadezimal-Wert von Griin und BB der Hexadezimal-Wert von Blau. Das 
folgende Beispiel entspricht dem vorangegangen Beispiel: 

c=&cFFFFFF 

FF ist der Hexadezimal-Wert fiir 255. Es gibt einen einfachen Weg, die Hexdezimal-Werte zu bestimmen. In der Neue 
Konstante-Dialogbox k6nnen Sie eine Konstante vom Typ Color definieren und mit Hilfe der integrierten Farbauswahl 
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(Color Picker) eine Farbe auswahlen. Nach getroffener Farbauswahl bestimmt REALbasic automatisch den Hexadezi- 
mal-Wert und tragt ihn im Feld Wert“ der Dialogbox ein. 


Es soll die ForeColor-Eigenschaft eines Graphics-Objekts auf Blau gesetzt werden, so dass der Text blau ausgegeben 
wird: 
Sub Paint(g as Graphics) 

g.ForeColor=Rgb(9,13,80) 

g.DrawString "Hello World",50,50 
End Sub 
In der Entwicklungsumgebung kGnnen Sie Farben mit dem Farben- und Eigenschaftenfenster erzeugen und zuweisen. 
Das Farbenfenster besteht aus einer Palette von bis zu 16 Farben. Wenn Sie das Farbenfenster das erste Mal aufrufen, 
sind noch keine Farben zugewiesen. Klicken Sie auf ein leeres Kastchen des Farbenfensters, um ihm eine Farbe zuzuwei- 
sen. Es erscheint die Farbauswahl, in der Sie die gewiinschte Farbe auswahlen k6nnen. Ein Vorteil dieser Methode ist, 
dass Sie dazu keine RGB-, HSV- oder CMY-Werte kennen miissen. 
Nachdem Sie dem Farbenfenster Farben zugewiesen haben, kGnnen Sie einer Objekt-Eigenschaft, die eine Farbe akzep- 
tiert, eine Farbe einfach durch das Draggen der Farbe aus dem Farbenfenster auf die gewtinschte Eigenschaft im Eigen- 
schaftenfenster zuweisen. 


Abb. 211: Draggen einer Farbe aus der Farbpalette auf die gewiinschte Eigenschaft im Eigenschaftenfenster 
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Wenn Sie mit dem Code-Editor arbeiten, k6nnen Sie den Wert einer Farbe des Farbenfensters einer Eigenschaft, die 
einen Farbwert annehmen kann, im Code zuweisen, indem Sie die Farbe in die entsprechende Codezeile draggen. Dies 
wird am besten anhand eines Beispiels verdeutlicht: 
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Abb. 212: Durch Draggen aus dem Farbenfenster einer Eigenschaft einen Farbwert zuweisen 
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In der Abbildung hat der Benutzer zuerst die Einftigemarke hinter das Gleichheitszeichen einer Codezeile gesetzt, die 
einer Eigenschaft einen Farbwert zuweist. AnschliefSend draggt er eine Farbe aus dem Farbenfenster in diese Codezeile. 
Wenn er die Maustaste loslasst, wird der RGB-Wert fiir diese Farbe an der Einfiigemarke eingesetzt. Da eine gedraggte 
Farbe den Farbwert auch als Text enthalt, kann eine Farbe aus dem Farbenfenster auch auf ein anderes Objekt gedraggt 
werden, das gedraggten Text annimmt , wie beispielweise der Finder oder ein Texteditor wie BBEdit. 


Ermitteln des RGB-Werts einer Farbe 


Wenn Sie zur Laufzeit eine Farbe zuweisen miissen und nicht wissen, welche RGB-Werte zu einer bestimmten Farbe 
gehGdren, konnen Sie den Mac OS-Color Picker verwenden, um diese Werte zu ermitteln. Folgender Code zeigt den 
Mac OS-Color-Picker: 

Dim c as Color 

Dim b as Boolean 

b=SelectColor(c,"Wahle eine Farbe") 

if b then //Anwender hat eine Farbe gewdhlt 

// Mache hier irgendetwas mit dieser Farbe 

end if 

Wenn der Anwender die Color-Picker-Dialogbox mit ,,Abbrechen“ verlassen hat, hat die Variable ,,b“ den Wert False, 
andernfalls wird die ausgewahlte Farbe im Color-Objekt ,,c“ zurtickgeliefert und steht fiir die Zuweisung zur Farbeigen- 
schaft eines Objektes zur Verftigung. 


Sie haben diesen vielleicht schon einmal eingesetzt, um einem Steuerelement im Interface-Builder eine Farbe zu geben. 
Im Classic Mac OS und unter Windows sieht er aus wie in der folgenden Abbildung. 
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Abb. 213: Die Macintosh- und Windows-Farbauswahl 
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Die Mac OS 8/9-Farbauswahl bietet mehrere Farbmodelle. Bei der Farbauswahl von Mac OS X klicken Sie auf eine Farbe 
und es erscheint eine Vorschau im Farbfeld am oberen Fensterrand. Sobald Sie auf OK klicken, wandelt REALbasic Ihre 
Auswahl in RGB-Werte um. Wenn Sie eine leichter zu tiberschauende Auswahl an Farben wiinschen, dann wahlen Sie 
den Crayon Picker (Farbstift-Auswahl). Den gibt es unter Mac OS X und Mac OS 9. 

Abb. 214: Die Crayon- (Buntstift-) Farbauswahl unter Mac OS 
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Der Crayon Color Picker zeigt Stifte mit den gebrauchlicher Farben. Um eine Farbe auszuwahlen, klicken Sie einen Stift 
an. Die Windows-Version des Color Pickers kennt nur eine Darstellung. Sie k6nnen entweder eine der vorgegebenen 
Farben auswahlen (so wie Sie es beim Apple Crayon Picker tun wiirden) oder Sie klicken auf ,,Farben definieren“, um 
sich den umfangreicheren Color Picker anzeigen zu lassen. Hier konnen Sie die Farbe iiber das RGB- oder das 
HSV-Model festlegen. 


Abb. 215: Farbauswahl unter Windows XP 
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Wahlen Sie eine Farbe aus, indem Sie auf einen Punkt im Farbspektrum klicken oder geben Sie bei RGB bzw. HSV die 
entsprechenden Werte ein. Klicken Sie auf ,,Farben hinzuftigen“, um die Farbe in die Gruppe der anderen Farbbeispiele 
auf der linken Seite dieser Dialogbox mitaufzunehmen. 


Die Pixel-Eigenschaft von Graphics-Objekten 


Die Pixel-Eigenschaft eines Graphics-Objekts erlaubt das Setzen und das Auslesen eines beliebigen Pixels. Die Eigen- 
schaft hat den Typ Color. Im Beispiel wird im Paint-Event-Handler ein Pixel schwarz eingefarbt, wenn es weif ist und 
weils eingefarbt, wenn es schwarz ist: 


Sub Paint(g As Graphics) 
If g.Pixel(10,20)=Rgb(0,0,0) Then 
g.Pixel (10,20)=Rgb(255, 255,255) 
Else 
g.Pixel(10,20)=Rgb(0,0,0) 
End If 
End Sub 


Man sieht, dass der Code ftir das Lesen der Farbe dem Code zum Setzen der Farbe entspricht. 


Drucken von Text und Grafik 


REALbasic erlaubt Ihnen, die Papierformat-Dialogbox aufzurufen und die Einstellungen des Benutzers zu sichern oder 
die Druckdialogbox vor dem Ausdruck anzuzeigen. Sie haben die Wahl, ob Sie vor dem Drucken die Drucken-Dialogbox 
anzeigen oder nicht. 


Beim Drucken geht man fast genauso wie beim Ausgeben von Text oder Grafik in einem Canvas-Steuerelement oder in 
einem Fenster vor. Uber die Funktionen OpenPrinter oder OpenPrinterDialog erhalt man ein Graphics-Objekt. Ruft man 
die NextPage-Methode dieses Objekts auf, wird die Seite ausgegeben. Sie gibt das Graphics-Objekt an den Drucker wei- 
ter und léscht seinen Inhalt, so dass Sie mit dem Aufbau der nachsten Seite beginnen k6nnen. 


Die Papierformat-Dialogbox 


Uber die Klasse PrinterSetup kann ein Objekt erzeugt werden, in dem man die Papierformat-Dialogbox anzeigen kann. 
Um diese anzuzeigen, rufen Sie die PageSetupDialog-Methode des PrinterSetup-Objekts auf. Diese Methode liefert 
den Wert True, wenn der Benutzer den OK-Knopf im Dialog geklickt hat oder False, wenn der Abbruch-Knopf geklickt 
wurde. Die PrinterSetup-Klasse bietet Eigenschaften ftir alle Einstellungen in der Papierformat-Dialogbox (Seitenausrich- 
tung, Skalierung und so weiter). Eine Zusammenfassung der Eigenschaften finden Sie unter Printer-Klasse im Sprachre- 
ferenz-Handbuch. Meistens werden Sie allerdings mit den einzelnen Eigenschaften nichts zu tu haben, da sie allesamt in 
der SetupString-Eigenschaft zusammengefasst sind. Die SetupString-Eigenschaft kann gelesen und geschrieben werden, 
so dass Sie damit sehr einfach alle Einstellungen des PrinterSetup speichern und spater wiederherstellen konnen. In 
einem Programm, mit dem der Benutzer Dokumente bearbeiten kann, konnte man dem Dokumentfenster eine Eigen- 
schaft vom Typ String geben, in der man den Wert des SetupString speichern kann. Wahlt der Benutzer den Mentipunkt 
Seitenformat, der sich bei den meisten Programmen im Ablage-Menii befindet, wird ein PrinterSetup-Objekt erzeugt, 
dessen SetupString-Eigenschaft alle Einstellungen enthalt. Danach wird die Seitenformat-Dialogbox dargestellt und zeigt 
diese Einstellungen an. Im Beispiel heifst die Eigenschaft ,,Settings*: 


Dim ps as PrinterSetup 
ps=New PrinterSetup 
ps.SetupString=Settings 

If ps.PageSetupDialog Then 
Settings=ps.SetupString 
End if 
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Klickt der Benutzer in der Seitenformat-Dialogbox auf OK, wird der Eigenschaft Settings der Wert des SetupStrings zuge- 
wiesen, da der Benutzer méglicherweise neue Einstellungen vorgenommen hat. 


Den OpenPrinter- und OpenPrinterDialog-Funktionen kann man optional PrinterSetup-Objekte als Parameter tiberge- 
ben, so dass die Einstellungen beim Ausdruck verwendet werden k6nnen. 


Sollen die Druckeinstellungen mit dem Dokument gespeichert werden, dann werden Sie diese vermutlich in der 
Resource Fork des Dokuments ablegen wollen. Mehr dazu erfahren Sie im Kapitel ,,Mit Dateien arbeiten“ auf Seite 280. 


Die Papierformat-Dialogbox wird momentan unter Linux nicht untersttitzt. Der Aufruf der PrinterSetup-Funktion liefert 
False zurtick und es wird kein Dialog angezeigt. 


Ausdrucken mit der Druckdialogbox 


Um die Druckdialogbox darzustellen und den Ausdruck zu starten, verwenden Sie die Funktion OpenPrinterDialog. 
Klickt der Benutzer in der Dialogbox auf OK, dann liefert die Funktion ein Graphics-Objekt. Klickt er auf Abbruch, gibt 
die Funktion Nil zuriick. Ftir den Aufbau der ersten Druckseite verwenden Sie das Graphics-Objekt, das Ihnen die Funk- 
tion geliefert hat und zeichnen in diesem Objekt mittels der tiblichen grafischen Methoden wie DrawString, DrawLine, 
DrawOval, DrawPicture, etc. Ist die Seite komplett, wird sie mit der NextPage-Methode zum Drucker geschickt, die das 
Graphics-Objekt danach wieder leert, so dass Sie mit dem Aufbau der nachsten Seite beginnen konnen. 


Dieses Beispiel gibt Hello“ auf der ersten und World" auf der zweiten Seite aus: 


Dim page as Graphics 

page=OpenPrinterDialog() 

If page<> nil Then 
page.DrawString "Hello", 50, 50 
page.NextPage 
page.DrawString "World", 50, 50 
page. NextPage 

End 


Die Angaben tiber die zu druckenden Seiten, die der Benutzer in der Dialogbox festlegen kann, werden automatisch 
berticksichtigt. Hat der Benutzer ,,von Seite 2 bis Seite 2“ eingestellt, wird nur die zweite Seite ausgedruckt. 


Haben Sie die SetupString-Eigenschaft eines PrinterSetup-Objekts gespeichert, konnen Sie diese optional an die Open- 
PrinterDialog-Funktion weitergeben, damit diese Einstellungen berticksichtigt werden. Im Beispiel wird angenommen, 
dass der SetupString in einer Eigenschaft namens ,,Settings“ abgelegt ist. Die Einstellungen werden dann an den Open- 
PrinterDialog weitergegeben: 


Dim page as Graphics 

Dim ps as PrinterSetup 

ps=New PrinterSetup 

If Settings <> "" Then 
ps.SetupString=Settings 

End If 

age=OpenPrinterDialog(ps) 

f page <> nil Then 
page.DrawString "Hello", 50, 50 
page.NextPage 

page.DrawString "World", 50, 50 
page.NextPage 

End If 


an) 


Weitere Informationen zur OpenPrinterDialog-Funktion finden Sie in der Sprachreferenz. 
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Drucken ohne Druckdialog 


Um direkt zu drucken, ohne zuvor die Druckdialogbox zu zeigen, rufen Sie die OpenPrinter-Funktion auf. Die Funktion 
arbeitet analog zur OpenPrintDialog-Funktion. Mehr dazu finden Sie unter OpenPrinter im Sprachreferenz-Handbuch. 


Drucken von Styled Text 


EditFields sind in der Lage, Texte in verschiedenen Schriftarten und -gréen darzustellen. Ftir den Ausdruck solcher 
Texte ist die Klasse StyledTextPrinter zustandig, die die Methode DrawBlock (anstelle von DrawString) verwendet. Es 
folgt ein einfaches Beispiel, das den Inhalt eines EditFields als Styled Text ausdruckt (Die StyledTextPrinter-Methode lie- 
fert Nil, wenn die MultiLine-Eigenschaft des EditFields nicht auf True gesetzt ist. Natiirlich kann man auch keinen Styled 
Text in ein EditField eingeben, wenn die Eigenschaften MultiLine und Styled nicht True sind). 

dim stp as StyledTextPrinter 

dim g as Graphics 

g=openPrinterDialog() 

if g <> nil then 

stp=EditFieldl.StyledTextPrinter(g,72*7.5) 

stp.drawBlock 0,0,72*9 

end if 


DrawBlock erwartet als Parameter die X,Y-Koordinate, an der die linke obere Ecke des Blocks auf der Seite erscheinen 
soll, und die Hohe des Blocks. Das Beispiel gibt den Block links oben auf der Seite aus. Weitere Informationen finden Sie 
in der Sprachreferenz unter StyledTextPrinter. 


Das REALbasic-Tutorial enthalt ein Kapitel, wie man Styled Text in einem EditField druckt. Es enthalt Code zum Drucken 
von mehr als einer Seite und zum Einstellen des druckbaren Bereichs auf der Seite. Weitere Informationen hierzu finden 
Sie im Tutorial ab Seite 50. 


Text und Grafik ber das Clipboard austauschen 


Das Clipboard ist eine Klasse. Die Methoden und Eigenschaften des Clipboard erlauben Ihnen festzustellen, welche 
Daten sich im Clipboard befinden, Daten an das Clipboard zu senden und Daten vom Clipboard zu empfangen. Das Clip- 
board kennt drei Arten von Daten: Text, Grafik und Bindrdaten. Letztere werden in einem String gespeichert und mit 
einem Datentyp Ihrer Wahl markiert, so dass man feststellen kann, welche Art von Daten im Clipboard vorliegen. 


Bei EditFields kiimmert sich REALbasic automatisch um die Behandlung von Cut, Copy und Paste im Edit-Menti. Bei 
anderen Steuerelementen, die Daten enthalten kGnnen, wie Canvas oder ListBox, ist dies aber nicht der Fall. 

Um auf das Clipboard zuzugreifen, miissen Sie zunachst ein Objekt vom Typ Clipboard erzeugen: 

Dim c as Clipboard 

c=New Clipboard 

Im Event-Handler, der das Clipboard 6ffnete, mtissen Sie die Close-Methode des Clipboard-Objekts aufrufen, damit kein 
Fehler auftritt. 


Feststellen des Typs der Daten im Clipboard 


Sie konnen den Typ der Daten im Clipboard mit folgenden Methoden und Eigenschaften feststellen, die jeweils True 
oder False zuriickliefern: TextAvailable, PictureAvailable und MacDataAvailable. MacDataAvailable wird verwendet, um 
herauszufinden, ob eine bestimmte Art von Binardaten im Clipboard liegt (gewGhnlich testen Sie damit auf Daten, die 
Thre eigene Anwendung dort abgelegt haben k6nnte). Um die MacDataAvailable-Methode zu verwenden, miissen Sie ihr 
den Maclype-String tibergeben, mit dem der entsprechende Datentyp markiert ist. Der String wurde beim Ablegen der 
Daten auf dem Clipboard an das Clipboard tibergeben. 
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Auslesen von Daten des Clipboards 


Nachdem Sie wissen, welche Art von Daten auf dem Clipboard vorliegt, konnen Sie diese mit den Eigenschaften Text, 
Picture und MacData auslesen. Im Beispiel wird ein Text (sofern vorhanden) in die Variable ,,Cliptext“ geholt: 


Dim c as Clipboard 

Dim ClipText as String 
c=New Clipboard 

If c.TextAvailable Then 
ClipText=c.Text 

End If 

C.Close 


Ist ein Bild im Clipboard, dann legen wir es in ,,ClipPict*: 


Dim c as Clipboard 

Dim ClipPict as Picture 
c=New Clipboard 

If c.PictureAvailable Then 
ClipPict=c.Picture 

End If 

C.Close 


In nachsten Beispiel wurden Zeilen einer ListBox ins Clipboard kopiert. Diese werden nun ausgelesen und in eine List- 
Box eingefiigt. 


dim theRows as string 
dim c as clipboard 
c=New Clipboard 
If c.MacDataAvailable("rows") Then 
theRows=c.MacData("rows") 

Do 
Listbox1l.AddRow Left(theRows, InStr(theRows ,Chr(13))-1) 
theRows=Mid(theRows, InStr(theRows , Chr(13) )+1) 

Loop until theRows="" 

End If 
C.Close 


Denken Sie daran, dass Sie die Close-Methode des Clipboard-Objekts im Event-Handler, der das Objekt geoffnet hat, auf- 
rufen miissen, weil sonst ein Fehler auftritt. 


Daten auf dem Clipboard ablegen 


Sie konnen Text, Bilder oder Bindrdaten (in Form eines Strings) im Clipboard ablegen. Dazu erzeugen Sie ein Clip- 
board-Objekt und verwenden die Methoden oder Eigenschaften, die zum Typ der Daten passen, die Sie im Clipboard 
ablegen mochten. 


Tabelle 31. Methoden und Eigenschaften, um Daten im Clipboard abzulegen 


Datentyp Methode oder Eigenschaft 
Text SetText-Methode 

Bild Picture-Eigenschaft 
Binardaten AddMacData-Methode 


So wird Text ins Clipboard befordert: 


Dim c as Clipboard 
c=New Clipboard 
c.SetText "Hello World" 
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c.Close 
So kopiert man ein Bild vom Objekt Canvas1 in das Clipboard: 


Dim c as Clipboard 

c=New Clipboard 
c.Picture=Canvas1.Backdrop 
c.Close 


Im nachsten Beispiel werden Zeilen einer ListBox in das Clipboard kopiert. Sie werden mit der AddMacData-Methode 
kopiert, so dass sie nicht als Text im Clipboard erscheinen: 


Dim i as Integer 

Dim c as Clipboard 

Dim rows as String 

c=New Clipboard 

For i=0 to ListCount 

If Listboxl.Selected(i) Then 
rows=rows+Listboxl.List(i )+Chr(13) 
End If 

ext 

c.AddMacData rows, "rows" 
c.Close 


Denken Sie daran, dass Sie die Close-Methode des Clipboard-Objekts im Event-Handler, der das Objekt geoffnet hat, auf: 
rufen miissen, weil sonst ein Fehler auftritt. 


Animationen mit Sprites 


Das SpriteSurface-Steuerelement wird benutzt, wenn Bilder bewegt werden sollen. Dabei kiimmert sich SpriteSurface 
selbstandig um das Neuzeichnen. Jedes Bild ist ein Sprite-Objekt. Diese haben Eigenschaften ftir die Koordinaten, an 
denen sie sich wahrend der Animation befinden. 


Bewegen von Sprites und Andern des Bildes 


Der NextFrame-Event-Handler wird immer dann aufgerufen, wenn SpriteSurface bereit ist, das nachste Bild (Frame) der 
Animation zu zeichnen. Wenn ein Sprite im nachsten Bild eine andere Position haben soll, indern sie dessen X/Y-Eigen- 
schaft im NextFrame-Event-Handler. Soll er sein Aussehen dndern, dann modifizieren Sie seine Image-Eigenschaft. Um 
einen Sprite aus der Animation zu léschen, rufen Sie dessen Close-Methode auf. 


Neuzeichnen der Frames 


Die Geschwindigkeit, mit der die Frames neu gezeichnet werden, hangt von der Eigenschaft FrameSpeed ab. Sie 
bestimmt, wie oft pro Sekunde das Monitor-Bild neu aufgebaut und der NextFrame-Event-Handler aufgerufen wird. 


FrameSpeed legt fest, wie oft der Bildschirminhalt neu gezeichnet werden soll, bevor ein Frame neu gezeichnet wird. 
Eine FrameSpeed von 0 sorgt daftir, dass der Rechner die Frames mit der héchstméglichen Geschwindigkeit neu zeich- 
net. Um die passende FrameSpeed zu berechnen, teilen Sie 60 durch die Anzahl der Frames, die pro Sekunde gezeichnet 
werden sollen und runden Sie das Ergebnis auf den nachsten Integer-Wert. Jedes Neuzeichnen eines Frames lést ein 
NextFrame-Event aus. 


Beginn und Ende der Animation 


Um eine Animation zu starten, rufen Sie die Run- oder Update-Methode von SpriteSurface auf. Die Update-Methode 
ldsst die Animation genau einen Schritt ausfiihren — sie zeichnet die Sprites neu, die sich bewegt oder geandert haben, 
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sendet Collisions-Events und ruft den NextFrame-Event genau einmal auf. Sie konnen das SpriteSurface animieren, 
indem Sie Update wiederholt aufrufen — z.B. tiber ein Timer-Steuerelement. Um die Animation zu stoppen, rufen Sie die 
Stop-Methode des SpriteSurface auf. Mit der Close-Methode iibergeben Sie den Bildschirm an das Fenster, das das 
SpriteSurface-Steuerelement enthalt. 


Der SpriteSurface-Bereich 


Das SpriteSurface ist ein ,,regulares“ Steuerelement mit den Eigenschaften Left, Top, Width und Height, die gelesen und 
geschrieben werden kénnen. Die Gré&e des SpriteSurface-Steuerelements kann in der Entwicklungsumgebung gedn- 
dert werden, indem man die Greifpunkte mit der Maus bewegt oder indem man diese Eigenschaften bearbeitet. Die 
Grose kann auch zur Laufzeit tiber diese Eigenschaften gedndert werden. 


Um ein SpriteSurface-Steuerelement so zu andern, dass es den gesamten Bildschirm tibernimmt, setzen Sie die Full- 
Screen-Eigenschaft des Elternfensters auf True und MenuBarVisible auf False und schalten Sie die ,.Lock“-Eigenschaften 
ein, damit sich die Grose des SpriteSurface-Steuerelements zusammen mit dem Elternfenster andert. Dies passt auto- 
matisch die Eigenschaften Left, Top, Width und Height an. 


In der Backdrop-Eigenschaft von SpriteSurface kann ein Bild abgelegt werden, das bei Beginn der Animation angezeigt 
wird. Sie konnen dieses auch verandern, wahrend die Animation lauft. 


Sie sollten es jedoch vermeiden, in dem Bereich zu zeichnen, in dem gerade eine Animation ablauft. Dieser Bereich wird 
durch die Eigenschaften SurfaceWidth, SurfaceHeight, SurfaceLeft und SurfaceTop festgelegt. 


Reagieren auf Benutzereingaben wahrend der Animation 


Im NextFrame-Event-Handler kénnen Sie mit der KeyTest-Methode eventuell gedriickte Tasten abfragen. Sie tibergeben 
der Methode den Key-Code einer Taste und KeyTest liefert True zurtick, wenn die Taste gedriickt wurde. Key-Codes sind 
keine ASCII-Codes, weil einige Tasten keinen zugeordneten ASCII-Wert haben (wie beispielsweise Shift, ctrl oder 
Befehlstaste). Key-Codes sind spezielle Codes, die jeder Taste auf der Tastatur zugeordnet sind. Diese k6nnen allerdings 
von Tastatur zu Tastatur verschieden sein. Beispielsweise gibt es Unterschiede zwischen einer englischen und einer fran- 
zésischen Tastatur. 


Abb. 216: Key-Codes auf verschiedenen Tastaturen 
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3D-Grafik-Animationen mit dem RB3DSpace-Steuerelement 


Sie konnen das RB3DSpace-Steuerelement zum Erzeugen von Animationen im dreidimensionalen Raum verwenden. Es 
arbeitet in Verbindung mit 3D-Klassen, mit denen Sie 3D-Objekte laden, gruppieren und manipulieren k6nnen. Das 
Basis-3D-Objekt ist von der Object3D-Klasse abgeleitet; 3D-Objekte werden dem Anwender tiber das RB3DSpace-Steue- 
relement prasentiert. 

Die 3D-Fahigkeiten von REALbasic basieren auf bestehenden 3D-Bibliotheken, die viel Power ftir einen geringen Preis 
bieten. Wenn Sie oder Ihre Endbenutzer Anwendungen benutzen, die 3D-Animationen verwenden, miissen die entspre- 
chenden Bibliotheken installiert sein. 


Zwei voneinander unabhangige Bibliotheken sind erhiltlich: QuickDraw 3D von Apple, und Quesa, eine 
Open-Source-Bibliothek, die fiir verschiedene Plattformen erhaltlich ist. 


Unter Mac OS Classic bendtigen Sie QuickDraw 3D, das standardmiifig installiert ist. Wenn es aus irgendwelchen Griin- 
den nicht mehr vorhanden sein sollte, dann konnen Sie es tiber den QuickTime Installer neuinstallieren. 

Unter Mac OS X miissen Sie Quesa und OpenGL installieren. 

Unter Windows miissen Sie Quesa und OpenGL installieren. 

Quesa erhalten Sie unter www.quesa.org. QuickTime erhalten Sie von Apple Computer unter www.apple.com/quick- 
time. 

Da es sehr schwierig ist, 3D-Animationen auf einer gedruckten Seite zu illustrieren, sollten Sie sich am besten die 
3D-Beispiel-Projekte von der REALbasic CD anschauen. Das RB 3D Demo illustriert die folgenden Bewegungen: 

© Yaw: Cursor links/rechts 

© Pitch: Cursor hoch/runter 

e Zoom: +/- Tasten bewegen die Kamera“ im 3D-Raum. 

Der Hintergrund und jede Figur in der Demo ist ein 3DMF-Objekt, das in das RB3DSpace geladen wird. 


Oo - RB3D Demo =I 


Keys 


Left/Right: Yaw 

Up/Down: Pitch 
PUp/Pg0n: Roll 
+: Move Forward 
-: Move Backward 


(OK, so they're not the 
greatest choices, but 
hey, it's only a demo!) 
Oo Wireframe 
Debug Cube 


Pro = om 
@ Spin 
© Bulge 


MouseExit 


Animationen werden mit den Tasten durchgefiihrt, die im rechten Teil des Fensters beschrieben sind und der zugeh6- 
rige Code sieht folgendermafsen aus: 


Select case asc(Key) 
case 28 // left 
View3D1.Camera.Yaw 0.1 
case 29 // right 
View3D1.Camera.Yaw -0.1 
case 30 // up 


3D-Grafik-Animationen mit dem RB3DSpace-Steuerelement 


279 


View3D1.Camera. 
case 31 // down 
View3D1.Camera. 
case 1l // page 
View3D1.Camera. 
case 12 // page 


View3D1.Camera. 
case 43 // keyp 
View3D1.Camera. 
case 45 // keyp 
View3D1.Camera. 
case asc("r") 
mPenguin.Yaw -0 
else 
Status.text = " 
return true 

end select 


View3D1.Refresh 


Pitch -0.1 


Pitch 0.1 

up 

Roll -0.1 

down 

Roll 0.1 

ad + 

oveForward 10.0 
ad - 

oveForward -10.0 


wal 


Unbekannte Taste: " + str(asc(Key) ) 


View3D1 ist das RB3DSpace Steuerelement und die Methoden Yaw, Pitch, Roll und MoveForward der Object3D-Klasse 


liefern die Animationen, wenn der Anwender die entsprechenden Tasten driickt. 


Informationen dariiber, wie Sie Objekte in eine 3D-Umgebung einbauen und animieren k6nnen, finden Sie in der 


Sprachreferenz. 
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knits Mit Dateien arbeiten 


Die meisten Anwendungen lesen und schreiben Dateien. Einige sichern Daten in einem eigenen Format. Oft wird der 
Benutzer eine Dialogbox zum Laden oder Speichern der Dateien bendtigen. REALbasic stellt daftir zahlreiche Funktio- 
nen zur Verfligung. 


Inhalt 


Welche Dateitypen gibt es? 

Was sind Folderltems? 

Zugriff auf Dateien 

Text- und Binardateien 

Bild-, Sound- und QuickTime-Dateien 
Lesen und Schreiben in der ResourceFork 
Umgang mit Dateien als Parameter 


Welche Dateitypen gibt es? 


Es gibt viele verschiedene Dateitypen. Der Dateityp definiert die Art der Daten, die in einer Datei abgelegt sind. Der 
Dateityp TEXT wird fiir Textinformationen benutzt, wahrend PICT eine Bilddatei bezeichnet. Jede Datei, die unter 
Mac OS Classic gespeichert wird, hat einen Dateityp, der in vier Buchstaben codiert wird. Ferner wird davon unabhangig 
eine Kennung mit vier Buchstaben abgelegt, die aussagt, welches Programm die Datei erzeugt hat. Dies ist der Creator. 
Unter Windows oder Mac OS X verwendet man zur Unterscheidung der Dateitypen einen Suffix, den ein Benutzer auch 
noch beliebig verandern kann (ein mehr als zweifelhaftes Verfahren). Die Kennung des Datentyps macht es einem Pro- 
gramm leichter zu bestimmen, ob es mit dem Inhalt einer Datei etwas anfangen kann. Erwartet ein Programm Dateien, 
die einen Text enthalten, sollte es nur solche Dateien 6ffnen, die die Kennung TEXT tragen. Bei Bilddateien spricht man 
oft von PICT-Dateien, was darauf zurtickzuftihren ist, dass deren Kennung PICT ist. Programme haben die Kennung 
APPL, was dem Mac-Betriebssystem mitteilt, dass es sich um ein ausftihrbares Programm handelt. (Zum Vergleich: Unter 
Windows/DOS ist dies die Endung .exe, die man aber sehr einfach jeder beliebigen Datei verpassen kann). 


Damit Sie sich nicht so intensiv damit beschaftigen miissen, verwaltet REALbasic diese Informationen tier ,,file types“. 
Ein solcher ,,file type“ wird in Ihrem Projekt abgelegt und enthalt die Kennungen ftir einen Creator (ihr Programm) und 
die Dateitypen. Jeder Dateityp hat einen Namen, den Sie in Ihrem Programm verwenden, wenn Sie Dateien offnen oder 
speichern. So konnen Sie mit Begriffen arbeiten, die Sie selbst bestimmen k6nnen, statt sich kryptische Kennungen zu 
merken. Auerdem macht es das Projekt weniger abhangig vom Mac OS. 


Die Creator-Codes unterscheiden kleine und grofe Buchstaben und miissen eindeutig einer Anwendung zugeordnet 
sein. Dazu kann man bei Apple einen Creator-Code registrieren. Dies geht im Internet unter: 
http://developer.apple.com/devw/cftype/find.html. 


Die Dialogbox ,,Dateitypen” 


Die Dialogbox ,,Dateitypen“ wird verwendet, um die Datentypen zu bestimmen, die Ihr Programm verstehen soll. Sie 
erreichen die Box unter Bearbeiten/Dateitypen. 
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Abb. 217: Die Dateitypen-Dialogbox 


Dateitypen 


application/text 


6 > > 
___ New... ¢ Andern — ( Loschen 


> 


Diese Liste zeigt alle Dateitypen, die innerhalb des Projektes verwendet werden. Ohne weitere Angaben verwendet 
REALbasic zunachst den Dateityp ,,Text“ ftir alle Dateien. In der Dialogbox k6nnen weitere Typen angelegt werden. 
Hinzufiigen eines Dateityps 


Der Dateityp ,,text“ fiir Dateien mit dem Type ,TEXT“ ist bereits eingebaut. Das Dateityp-Vorlagen-Popup enthilt ein paar 
niitzliche Wildcard-Dateitypen. Sie sind in folgender Tabelle aufgelistet. 


Tabelle 32. Spezielle Dateitypen, die im Dateitypen-Dialog eingebaut sind 


Dateitypen-Name Type Creator Beschreibung 


special/any 222? ~~??? Beliebiger Type und Creator 
special/folder fold MACS Beliebiger Ordner (nur Mac OS) 
special/disk disk MACS Beliebiges Volume (nur Mac OS) 


Um einen neuen Dateityp zu bekommen: 
1. Ist die Dialogbox ,,Dateityp“ nicht ge6ffnet, dann 6ffnen Sie diese mit Bearbeiten/Dateitypen. 
2. Klicken Sie auf den Neu-Knopf. 


Abb. 218: Dialogbox zum Hinzufiigen von Dateitypen 


Dateityp bearbeiten 


Name: |hpplication/text | — Dateltypen- 
= Vorlagen 

Mac-Creator: text Mac-Typ: TEXT 

Extension: .1st;.nfo;.readme;readme 

__ Dokument-icon: Icon 


3. In der Dialogbox wahlen Sie aus den Vorgaben einen passenden Typ aus oder geben einen neuen Namen, Creator, 
Typ und eventuelle Suffixe an. 


4, Danach sichern Sie die Anderungen mit einem Klick auf OK. 


Andern des Dateityps 

1. Ist die Dialogbox ,,Dateityp“ nicht gedffnet, dann 6ffnen Sie diese mit Bearbeiten/Dateitypen. 
2. Klicken Sie den gewiinschten Typ an. 

3, Klicken Sie auf den Knopf Andern. 

4, Tragen Sie Ihre Anderungen ein und klicken Sie auf OK. 

5. Sichern Sie die Anderungen durch Verlassen der Dateityp-Dialogbox mit einem Klick auf OK. 
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Sollten Sie den Namen eines Dateityps andern, mtissen Sie alle Programmstellen, in denen dieser Name verwendet 
wurde, manuell andern. Das ist mit der Suchen- und Ersetzen-Funktion leicht méglich. 


Loschen eines Dateityps 

1. Ist die Dialogbox ,,Dateityp“ nicht gedffnet, dann dffnen Sie diese mit Bearbeiten/Dateitypen. 
2. Klicken Sie den gewiinschten Typ an. 

3. Klicken Sie auf den Knopf Léschen. 

4, Sichern Sie die Anderungen durch Verlassen der Dateityp-Dialogbox mit einem Klick auf OK. 


Wenn Sie einen Dateityp entfernen, sollten Sie sich sicher sein, dass dieser nirgends mehr im Projekt verwendet wird. 


Dateitypen verwenden 


Sie tibergeben einen oder mehrere Dateitypen in einem Befehl, um zu erreichen, dass nur die tibergebenen Dateitypen 
erlaubt sind. Folgendes Beispiel legt in einem Open-Event-Handler eines Steuerelements fest, dass es TEXT-Dateien 
akzeptiert, die vom Desktop aus darauf gezogen wurden. 

me.AcceptFileDrop( “text” ) 

Der Befehl 
f=GetOpenFolderItem("video/quicktime" ) 

zeigt eine ,,Datei offnen*-Dialogbox an, durch die der Anwender QuickTime-Filme sehen und 6ffnen kann. Um festzule- 
gen, dass man mehr als einen Dateityp akzeptiert, listen Sie die Dateitypen durch Semikolon getrennt auf. Folgendes 
Beispiel erlaubt dem Anwender, Dateien vom Typ PICT, GIF und JPEG zu sehen und zu 6ffnen. 


f=GetOpenFolderItem("image/x-pict; image/jpeg; image/gif") 
In der Sprachreferenz finden Sie zusatzliche Methoden, die Dateitypen als Argument besitzen. 


Definieren eigener Icons fur Ihr Programm 


Die meisten Programme verwenden eigene Dateien und ordnen diesen auch Icons (Piktogramme) zu. Diese sehen nor- 
malerweise dem Icon des Programms ahnlich. Dadurch wird es einfacher, Dateien, die zu einem Programm gehoren, zu 
identifizieren. Das klappt aber nur dann, wenn man dem Projekt einen Creator-Code gegeben hat und ein selbstandig 
ablaufendes Programm erzeugt wurde (das unabhangig von der REALbasic-Entwicklungsumgebung Iduft). 


Um dem Projekt eigene Icons zuzuordnen, weisen Sie als erstes Ihrer Anwendung einen Creator-Code zu. Dies ist inner- 
halb der IDE in den Projekt-Einstellungen oder den Compiler-Einstellungen moglich. 
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Abb. 219: Creator-Code in den Projekt- oder Compilereinstellungen festlegen 


Projekteinstellungen Einstellungen fiir Applikation erzeugen 
Default-Fenster: “Fensterl iz Erzeuge fiir: (Mac OS X 
Mac-Creator: 72? (Mac OS 8-9 (Classic) 
Vorgabesprache: {Standard a.) (Windows 98/NT/2000/XP 
© Linux/x86 
Mac OS Einstellungen. i) 
(. Abbrechen_) eor— 


ll Mac OS X-Name: Mein Programm 


Mac OS 8-9 Name: Mein Programm (Classic) | 
Creator Code: 777 | ( “Registrieren ) 
Speicher: 
Bevorzugt: 4096 k 
Minimum: 2048 k 


Kompatibilitat: CQ Mac OS X only (Mach-0) 
@ Mac OS 8-9 and X (PEF) 


(Icons... ) ( Abbrechen _) cor 


Geben Sie Ihren Creator-Code entweder im Mac-Creator-Feld der Projekt-Einstellungen oder im Creator Code-Feld unter 
den Macintosh-Einstellungen in den Compiler-Einstellungen ein. Creator-Codes sind case-sensitiv. 


. Wahlen Sie Bearbeiten/Projekt-Einstellungen. 

. Geben Sie eine Kennung ftir den Creator ein, die aus vier Buchstaben besteht. 
. Klicken Sie auf OK. 

. Wahlen Sie Bearbeiten/Dateitypen. 


1 
2 
3 
4 
5. Legen Sie einen neuen Dateityp an, oder dndern Sie einen bestehenden Typ. 
6. Beachten Sie, dass der Creator der Datei genau mit dem unter den Projekteinstellungen festgelegten iibereinstimmt. 
7. Priifen Sie, ob die Checkbox Datei-Icon angewahlt ist. 

8. Befordern Sie Ihr selbstdefiniertes Icon in das Clipboard. 

9. Klicken Sie auf das vorgegebene Icon, so dass es selektiert wird. 

10. Wahlen Sie Bearbeiten/Einfiigen (38-V oder Ctrl-V). 

11. Klicken Sie auf OK. 


Nachdem Sie das Piktogramm festgelegt haben, miissen Sie ein selbstandig laufendes Programm erzeugen und danach 
die Desktop-Datenbank des Finders neu aufbauen (unter Mac OS Classic). Sonst wird das Icon noch nicht automatisch 
angezeigt. Die Desktop-Datenbank wird neu aufgebaut, wenn Sie den Computer neu starten und dabei die Befehlstaste 
(Apfel) und die Option-Taste (alt) gedriickt halten, bis der Mac Sie fragt, ob Sie die Desktop-Datenbank neu aufbauen 
mochten. 


Was sind Folderltems? 


REALbasic behandelt Laufwerke, Ordner, Anwendungen und Dateien als Folderltems. Schlicht gesagt ist alles ein Folder!- 
tem, was auf dem Desktop erscheinen kann. Das gilt fiir Dateien ebenso wie fiir den Papierkorb. 


Die Folderltem-Klasse ist Ihr Zugang zu allem, was auf einem Speichermedium geschehen soll. Um eine Datei zu lesen, 
bendtigen Sie ein Folderltem und die Methoden, die es zur Verftigung stellt. Es gibt viele verschiedene Methoden, ein 
Folderltem zu erhalten, das dann ein Verzeichnis (Volume), eine bestimmte Datei etc. reprasentiert. Der Benutzer kann 
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es tiber eine Dialogbox wahlen, oder Sie konnen es aus einem bestimmten Pfad lesen oder es sogar von einem anderen 
Folderltem geliefert bekommen. Folderltems verfiigen iiber Eigenschaften, die den Pfad, den Namen, die Grofse, den 
‘Typ und so weiter beinhalten. AuSerdem bieten sie Methoden zum Anlegen, Loschen, Offnen, Kopieren etc. 


Detaillierte Informationen dazu unter Folderltem in der Sprachreferenz. 


Wie werden Aliase benutzt? 


Aliase sind Dateien, die als Stellvertreter fiir die eigentliche Datei agieren und weder genauso heifsen miissen, noch an 
derselben Stelle gespeichert sein miissen wie die Datei, ftir die sie stehen. REALbasic stellt Befehle bereit, die es Ihnen 
erlauben, entweder mit dem Originalobjekt zu arbeiten oder mit dem Alias selbst zu hantieren. 


Die Funktion GetFolderltem lést einen Alias automatisch auf, wahrend GetTrueFolderltem mit dem Alias selbst arbeitet. 


Lesen einer Datei an einer vorgegebenen Stelle 


Wenn Sie den vollstandigen Pfad zu einer Datei kennen, k6nnen Sie mit dessen Hilfe auf die Datei zugreifen. Wenn Sie 
aber beispielsweise auf das Dokument ,,Zeitplan“ zugreifen wollen, welches sich im gleichen Verzeichnis befindet wie die 
Applikation, so bendtigen Sie einen relativen Pfad. Der relative Pfad beginnt in dem Verzeichnis, in dem sich die Applika- 
tion befindet. Deshalb brauchen Sie nur den Namen des Dokuments (,,Zeitplan“) anzugeben, da es sich im gleichen Ver- 
zeichnis befindet, wie die Applikation. 


Der folgende Code erzeugt ein Folderltem-Objekt, das das Dokument ,,Zeitplan“ reprasentiert. 


Dim f as FolderItem 
f=GetFolderItem("Schedule" ) 


Die GetFolderltem-Funktion sollte nur verwendet werden, wenn Sie eine Datei oder ein Verzeichnis im Applikations-Ver- 
zeichnis oder einen leeren String (‘“‘) angeben. Letzteres liefert ein Folderltem-Objekt fiir das Verzeichnis, in dem sich 
die Applikation befindet. 

Dim f as FolderItem 

f=GetFolderItem("") //liefert das Applikations-Verzeichnis 

Der vollstandige Pfad, auch absoluter Pfad genannt, beginnt mit dem Volume-Namen, gefolgt von einer Reihe Verzeich- 
nisnamen, die mit einem Trennzeichen voneinander getrennt sind. Unter Macintosh ist dieses Trennzeichen ein Doppel- 
punkt, unter Windows ein Backslash. Das letzte Element des Pfades, ist der Dateiname oder Verzeichnisname, auf das 
Sie zugreifen méchten. 


Um einen absoluten Pfad zu erzeugen, sollten Sie mit der Volume-Funktion beginnen, der Sie das Volume tibergeben, 
auf dem sich die Datei oder das Verzeichnis befindet. Nun kénnen Sie mit Hilfe der Child-Methode der 
Folderltem-Klasse zum gewiinschten Verzeichnis bzw. zur gewtinschten Datei navigieren. Die Volume-Funktion liefert 
ein Folderltem-Objekt ftir das angegebene Volume. Als Parameter geben Sie den Index des Volumes an, wobei der Index 
0 immer das Boot-Volume liefert, auf dem sich das Betriebssystem befindet. 

Dim f as FolderItem 

f=Volume(0) // Liefert ein FolderItem fiir das Boot-Volume 

Die Parent-Methode hingegen liefert das tibergeordnete Verzeichnis zurtick. Dies funktioniert natiirlich nicht, wenn Sie 
das Folderltem eines Volumes angeben. Uber die Child-Methode greifen Sie auf Eintrage zu, die eine Verzeichnisebene 
tiefer liegen. 


Sie k6nnen mit Hilfe der Child-Methode einen absoluten Pfad erzeugen. Wenn Sie auf die Datei ,,Zeitplan“ im Verzeich- 
nis ,Verschiedenes“ auf dem Boot-Volume zugreifen mdchten, geben Sie folgendes an: 


Dim f as FolderItem 
f=Volume(0).Child("Verschiedenes").Child("Zeitplan") 
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Das folgende Beispiel verwendet den relativen Pfad, um mit Hilfe der Parent-Methode das Folderltem des Verzeichnisses 
zu bestimmen, in dem sich das Verzeichnis der Applikation befindet. 

Dim f as Folderitem 

f=GetFolderItem("").Parent 

Haben Sie ein Folderltem ftir die gewtinschte Datei oder das Verzeichnis, konnen Sie dieses — abhéngig vom Typ — 
kopieren, loschen, umbenennen, lesen, schreiben etc. Weitere Informationen dazu finden Sie weiter hinten in diesem 
Kapitel. 


Sicherstellen, dass man Zugriff auf das Objekt hat 


Wenn Sie versuchen, ein Folderltem ftir eine Datei oder ein Verzeichnis zu ermitteln, konnen zwei Dinge schief gehen. 
Als erstes kann der Pfad ungiiltig sein. Ein ungtiltiger Pfad enthalt einen Laufwerks- oder Ordnernamen, der nicht exis- 
tiert. Wenn der Volume-Index 1 ist, der Benutzer aber nur ein Volume (0) besitzt, liefert die Volume-Funktion Nil als Wert 
fiir die Folderltem-Instanz f. Wenn Sie versuchen, eine Eigenschaft oder Methode der Folderltem-Klasse zu verwenden, 
wird eine NilObjectException auftreten. Wenn diese Exception nicht abgefangen wird, stiirzt das Programm ab. Das 
sollte man verhindern. 


Zweitens kann es sein, dass die Datei, auf die Sie zugreifen wollen, nicht existiert. 
Folgender Code priift diese beiden Situationen: 


Dim f as FolderItem 
f=Volume(0).Child("Dokumente").Child("Zeitplan") 
If f <> Nil then 
If f.Exists then 
//Lugriff auf das FolderItem 


Else 
MsgBox "Das Dokument existiert nicht!" 
End if 
Else 
MsgBox "Ungtiltiger Pfad angegeben!" 
End if 


Wenn der Pfad giiltig ist, priift der Code die Exists-Eigenschaft des Folderltems, um sich zu vergewissern, dass die Datei 
schon vorhanden ist. Ist die Datei nicht vorhanden oder der Pfad ungiiltig, wird eine Warnmeldung angezeigt. 


Sie k6nnen einen ungiiltigen Pfad durch einen Exception Block abfangen. Mehr dazu erfahren Sie im Abschnitt ,Runtime 
Exception Fehler“ auf Seite 360. 


Auslesen von Informationen tiber ein Folderltem 


Wenn GetFolderltem ein giiltiges Folderltem auf ein vorhandenes Objekt liefert, konnen Sie mit der lokalen Variablen 
»f auf alle Informationen des Folderltems zugreifen. Zum Beispiel k6nnen Sie wie folgt das Anderungsdatum (modifica- 
tion date) herausbekommen: 
Dim f as FolderItem 
f=Volume(0).Child("Dokumente").Child("Zeitplan") 
if f <> Nil then 
if f.Exists then 
MsgBox f.ModificationDate.ShortDate 
End if 
End if 


Loschen eines Folderltem 


Fiir das Léschen ist die Methode ,,Delete“ des Folderltem zustandig: 
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Dim f as FolderItem 
f=Volume(0).Child("Dokumente").Child("Zeitplan") 
If f <> nil Then 
if f.Exists then 
f.Delete 
End if 
End if 
Ist das Folderltem geschiitzt, tritt dabei ein Fehler auf. Mit der Eigenschaft ,Locked“ des Folderltems asst sich das fest- 
stellen. 


Achtung: Das Loschen eines Folderltems verschiebt es nicht in den Papierkorb. Es wird sofort dauerhaft geléscht. 


Auslesen des Pfadnamens der Anwendung 


Das Ubergeben einer leeren Zeichenkette (Null-String, zwei direkt aufeinander folgende Anfiihrungszeichen) an die Get- 
Folderltem-Funktion liefert ein Folderltem zuriick, das den Pfad enthalt, in dem das Programm/Projekt sich befindet. Mit 
den Methoden dieses Folderltems konnen Sie auf alle Dateien zugreifen, die sich in dem Ordner befinden, in dem Ihr 
Programm gespeichert ist. Die Item-Eigenschaft liefert ein Array von Folderltems mit allen Objekten des Ordners. 


Zugriff auf Dateien im Pfad der Anwendung 


Ist der erste Teil eines Pfadnamens nicht der Name eines Volumes, geht die GetFolderltem-Funktion davon aus, dass sich 
das entsprechende Objekt im selben Verzeichnis befindet, in dem auch Ihr Programm liegt. Wird ein Projekt innerhalb 
von REALbasic gestartet, dann ist dies eben das Verzeichnis, in dem das Projekt gespeichert ist. Sollte es noch nicht 
gespeichert worden sein, dann ist dies der Pfad, in dem REALbasic sich befindet. 


Die Datei ,Eigene Vorlagen* im Ordner ,Vorlagen“, der sich im Verzeichnis des Programms befindet, erreicht man so: 


Dim f as FolderIte 
f=GetFolderItem(":Vorlagen:Eigene Vorlagen") 


Wenn die Datei sich im gleichen Ordner wie das Programm befindet, benotigen Sie den ftihrenden Doppelpunkt nicht: 


Dim f as FolderIte 
f=GetFolderItem("Eigene Vorlagen") 


Wenn sich die Datei im gleichen Ordner wie das Programm befindet, benétigen Sie den Doppelpunkt am Anfang nicht. 
Folgendes wiirde funktionieren: 


Dim f as FolderIte 
f=GetFolderItem("Eigene Vorlagen") 


Zugriff auf System-Ordner 


REALbasic hat spezielle Funktionen, um auf die wichtigen Systemverzeichnisse zuzugreifen. Die im folgenden aufgeliste- 
ten Funktionen werden auch dann korrekt arbeiten, wenn sich zwischenzeitlich der Name eines Ordners andert sollte. 
Die Funktionen sind auch unabhdngig von der Sprache und der Betriebssystemplattform. Mehr dazu finden Sie auch in 
der Sprachreferenz. 

AppleMenuFolder 

ControlPanelsFolder 

DesktopFolder 

ExtensionsFolder 

FontsFolder 

PreferencesFolder 

ShutDownltemsFolder 


Lesen des Dateinamens aus einer ,,Datei offnen”- Dialogbox 287 


© StartupltemsFolder 

© SystemFolder 

© TemporaryFolder 

e TrashFolder 

So kann man die Anzahl der Dateien im Papierkorb herausfinden: 


Dim f as FolderItem 
f=TrashFolder 
MsgBox "Objekte im Papierkorb: "+Str(f.Count) 


Lesen des Dateinamens aus einer ,,Datei offnen"- Dialogbox 


Die ,,Datei 6ffnen“-Dialogbox gestattet dem Benutzer das Auswahlen einer Datei auf jedem verfiigbaren Volume. 


Wenn das Programm unter Mac OS 8.5 oder neuer lauft, wird die Dateiauswahlbox der Navigation Services angezeigt. 


Abb. 220: Die Standarddateiauswahlbox ab Mac OS 8.5 
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Abb. 221: Der Mac OS X (10.3) Datei-Browser 
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Um dem Anwender eine Dialogbox zum Offnen anzubieten, konnen Sie entweder die GetOpenFolderltem-Funktion auf- 
rufen oder die OpenDialog-Klasse verwenden. Erstere ist eine Standard-Funktion, die den Standard-,,Datei dffnen‘-Dia- 
log anzeigt. Die zweite erlaubt Ihnen, einen eigenen ,,Datei offnen“-Dialog zu erzeugen, in dem Sie folgende Aspekte 
festlegen konnen: 


© Position (Left- und Top-Eigenschaften) 
© Ausgangsverzeichnis (Initial Directory-Eigenschaft) 
© Giiltige Dateitypen, die angezeigt werden sollen (Filter-Eigenschaft) 
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© Beschriftung der Bestatigen- und Abbrechen-Knépfe (ActionButtonCaption- & CancelButtonCaption-Eigenschaften) 
@ Text, der im Titelbalken des Dialogs erscheint (Title-Eigenschaft) 
© ‘Text, der innerhalb des Dialogs erscheint (PromptText-Eigenschaft) 


Die GetOpenFolderltem-Funktion zeigt eine ,Datei dffnen“-Dialogbox an und liefert ein Folderltem-Objekt, das die 
Datei, die der Anwender auswahlte, reprasentiert. Einer oder mehrere Dateitypen, die in der Dateitypen-Dialogbox fiir 
das Projekt definiert sein miissen, miissen dazu als Parameter tibergeben werden. Nur Dateien dieser Typen werden dem 
Benutzer zur Auswahl angeboten. Mehrere Typen werden durch Semikolon getrennt. 


Das folgende Beispiel zeigt eine ,,Datei offnen“-Dialogbox, in der der Benutzer eine JPEG- oder PICT-Datei wahlen kann. 
Danach wird das Anderungsdatum der selektierten Datei angezeigt: 

Dim f as FolderItem 

f=GetOpenFolderItem( "image/jpeg; image/x-pict") 

Msgbox f.ModificationDate.ShortDate 

Klickt der Benutzer auf Abbruch statt auf Offnen, liefert die Funktion ,,Nil zuriick. Auch hier miissen Sie wieder darauf 
achten, dass Sie das tiberpriifen, bevor Sie auf die Datei zugreifen, da sonst ein NilObjectException Fehler auftreten 
kann: 
Dim f as FolderItem 

f=GetOpenFolderItem( "image/jpeg; image/x-pict") 
If f <> Nil Then 


Msgbox f.ModificationDate.ShortDate 
End if 


Wenn Sie die OpenDialog-Klasse verwenden, erzeugen Sie ein neues Objekt, das auf dieser Klasse basiert und weisen 
seinen Eigenschaften Werte zu, um das Erscheinungsbild zu steuern. Folgendes Beispiel verwendet eine benutzerdefi- 
nierte Box und zeigt nur einen Dateityp an. 


Dim dlg as OpenDialog 
Dim f as FolderItem 
dlg=New OpenDialog 

dig. InitialDirectory=GetFolderItem("HD:FrameMaker6.0:0nlineManuals") 
dig.Title="Wdhle eine MIF-Datei" 

dig.Filter="application/x-mif" 

f=d1g.ShowModal () 

If f <> Nil then 

//Zeigt den vollstandigen Pfad zu den Dateien in einem EditField an 
esultEdit.text = dlg.Result.AbsolutePath 

Else 
esultEdit.text = "Benutzer-Abbruch" 
End if 


Mehr dazu siehe OpenDialog-Klasse und GetOpenFolderltem in der Sprachreferenz. Weitere Informationen zu Dateity- 
pen siehe Welche Dateitypen gibt es?“ auf Seite 280. 


Auslesen des gewahlten Ordners 


Die ,,Datei ffnen“-Dialogbox gestattet dem Benutzer nicht, einen Ordner auszuwahlen. Daher gibt es in REALbasic die 
Funktion SelectFolder, die eine ,Ordner wahlen‘-Dialogbox zeigt, in der der Benutzer einen Ordner wahlen kann. Die 
SelectFolder-Dialog-Klasse bietet die gleiche Funktion, erlaubt aber das Erscheinungsbild des Dialogs zu andern. 


Wenn der Anwender Mac OS 8.5 oder neuer einsetzt, erscheint die neue Auswahlbox der Navigation Services: 
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Abb. 222: Die ,,Ordner auswahlen”-Dialogbox unter Mac OS X und Windows 
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Die SelectFolder-Funktion liefert ein Folderltem, das den Ordner reprisentiert, den der Benutzer gewahlt hat, wenn er 
den Knopf ,,Auswahlen“ in der Dialogbox geklickt hat. Klickt er statt dessen auf ,,Abbrechen“ , liefert SelectFolder ,,Nil“. 
Auch das muss gepriift werden: 


Dim f as FolderItem 
f=SelectFolder 

If f <> Nil Then 
MsgBox Str(f.Count) 
End if 


Wenn Sie die SelectFolderDialog-Klasse verwenden, erzeugen Sie ein Objekt, das auf dieser Klasse basiert und weisen 
seinen Eigenschaften Werte zu, um das Erscheinungsbild festzulegen. Sie konnen folgende Eigenschaften steuern: 


Position (Eigenschaften Left und Top) 

Ausgangsverzeichnis (Eigenschaft Initial Directory) 

Giiltige Dateitypen, die angezeigt werden sollen (Eigenschaft Filter) 

Beschriftung der Bestatigen- und Abbrechen-Knodpfe (Eigenschaften ActionButtonCaption und CancelButtonCap- 
tion) 

Text, der im Titelbalken des Dialogs erscheint (Eigenschaft Title) 


e Text, der innerhalb des Dialogs erscheint (Eigenschaft PromptText) 


Folgender Code offnet eine benutzerdefinierte ,Ordner wahlen“-Dialogbox und zeigt den Inhalt des ,Dokumente“-Ord- 
ners auf dem Start-Volume im Browser an. 


Dim dlg as SelectFolderDialog 
Dim f as FolderItem 
dlg=New SelectFolderDialog 
dlg.ActionButtonCaption="Wdhle" 
dlg.InitialDirectory=Volume(0).Child("Dokumente" ) 
f=d1g.ShowModal () 

If f <> Nil then 

//Hier das FolderItem verwenden 
else 

//Benutzer-Abbruch 
end if 


Mehr dazu siehe SelectFolder und SelectFolderDialog Klasse in der Sprachreferenz. 


Benutzung der ,,Sichern unter” -Dialogbox 


Die ,,Sichern unter“-Dialogbox (Save as) wird verwendet, um eine Datei unter einem neuen Namen zu sichern. Wenn 
der Anwender Mac OS 8.5 oder neuer einsetzt, erscheint die neue Auswahlbox der Navigation Services. 
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Abb. 223: Eine Sichern unter/Sichern als-Dialogbox 
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Die Funktion GetSaveFolderltem zeigt diese Dialogbox an. Die SaveAsDialog Klasse erlaubt Ihnen, eine benutzerdefi- 
nierte Version dieser Dialogbox zu erzeugen. Beide Objekte liefern ein Folderltem, das die Datei reprasentiert, die der 
Benutzer sichern méchte. Die Datei existiert zu diesem Zeitpunkt noch nicht. Sie werden spater sehen, wie man den 
Programmcode realisiert, der die Datei anlegt und dann Daten in die Datei schreibt. 
Beim Aufruf der GetSaveFolderltem-Funktion definieren Sie den Dateityp und einen Namensvorschlag fiir die Datei (dieser 
erscheint dann im Name-Feld in der ,,Sichern“-Dialogbox). Der Dateityp muss in der Liste der Dateitypen des Projekts defi- 
niert worden sein. Auch hier miissen Sie priifen, ob der Riickgabewert von GetSaveFolderltem ,,Nil“ ist, bevor Sie ihn ver- 
wenden (Folderltem wird Nil, wenn der Anwender auf ,Abbrechen“ klickt), 
Im Beispiel wird eine ,Sichern unter“-Dialogbox gezeigt, die als Namensvorschlag ,Namenlos* enthalt. Es liefert au(ser- 
dem ein Folderltem, dessen Type und Creator auf den Dateityp ,image/x-pict“ passt, der fiir das Projekt in der Datei- 
typen-Dialogbox definiert wurde. Wenn der Anwender auf den Speichern-Knopf klickt, wird der Name, den der 
Anwender ausgewahlt hat, angezeigt: 
Dim f as FolderItem 
f=GetSaveFolderItem("image/x-pict","Namenlos") 
If f <> Nil Then 

MsgBox f.name 
End if 
Wenn Sie eine Textdatei erzeugen mochten, kénnen Sie auch eine leere Zeichenkette statt des Dateityps als ersten Para- 
meter tibergeben. Die Methode CreateTextFile legt Dateityp und Creator sowieso automatisch an. 
Wenn Sie die SaveAsDialog-Klasse verwenden, erzeugen Sie ein neues Objekt, das auf dieser Klasse basiert und weisen 
seinen Eigenschaften Werte zu, um das Erscheinungsbild festzulegen. Sie konnen folgende Eigenschaften steuern: 
© Position (Eigenschaften Left und Top) 
Ausgangsverzeichnis (Eigenschaft Initial Directory) 
Dateinamen-Vorgabe (Eigenschaft SuggestedFileName) 
Giiltige Dateitypen, die angezeigt werden sollen (Eigenschaft Filter) 
Beschriftung der Bestatigen- und Abbrechen-Knopfe (Eigenschaften ActionButtonCaption & CancelButtonCaption) 
Text, der im Titelbalken des Dialogs erscheint (Eigenschaft Title) 
Text, der innerhalb des Dialogs erscheint (Eigenschaft PromptText) 


Folgender Code 6ffnet eine benutzerdefinierbare ,,Sichern unter‘-Dialogbox und zeigt den Inhalt des Dokumente-Ver- 
zeichnisses im Datei-Browser an. 


Dim dlg as SaveAsDialog 
Dim f as FolderItem 
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dlg=New SaveAsDialog 
dlg.InitialDirectory=Volume(0).Child("Dokumente" ) 
dlg.promptText="Geben Sie einen Dateinamen ein" 
dlg.SuggestedFileName="RTF Datei" 
dig.Title="Speichern Sie Ihre Datei" 
f=d1g.ShowModal () 

If f <> Nil then 

//Datei gespeichert 

Else 

//Benutzerabbruch 

End if 


Mehr Informationen siehe Welche Dateitypen gibt es?“ auf Seite 280 oder in der Sprachreferenz unter ,,GetSaveFolder- 
Item“ und ,,SaveAsDialog in der Sprachreferenz*. 


Benutzen von Textdateien 


Textdateien sind Dateien, deren Dateityp TEXT ist. Sie konnen von Texteditoren (wie Simplelext oder BBEdit) oder von 
Textverarbeitungen (wie ClarisWorks) ge6ffnet werden. Textdateien sind sehr einfach in der Handhabung und man kann 
auch leicht tiberpriifen, was das eigene Programm in einer solchen Datei tatsachlich ablegt. 


Fiir jeden lesenden oder schreibenden Zugriff auf eine Textdatei benotigen Sie ein Folderltem. 


Lesen aus einer Textdatei 


Nachdem Sie das Folderltem erzeugt haben, das auf die zu lesende Datei verweist, verwenden Sie die Methode ,Open- 
AsTextFile“ der Folderltem-Klasse, um sie zu 6ffnen. Diese Methode 6ffnet einen Stream. Ein Stream ist ein Datenstrom, 
der Daten transportiert. In diesem Fall transportiert er die Textdaten aus Ihrer Datei in Ihr Programm. Deshalb wird er 
als TextInputStream bezeichnet. Diese Klasse ist darauf ausgerichtet, Textdateien zu lesen und stellt die Methoden Rea- 
dAll zum Lesen der kompletten Textdatei bis zur EOF-Marke (Ende der Datei) oder ReadLine zum zeilenweisen Auslesen, 
wobei jeweils das Carriage-Return-Zeichen ein Zeilenende markiert, zur Verftigung. Sie merkt sich auch die letzte Posi- 
tion, von der Sie aus der Datei gelesen haben. 


Die Lesefunktionen liefern jeweils eine Zeichenkette. Das Ende der Datei wird in der Eigenschaft EOF des TextInput- 
Stream angezeigt. Hat diese den Wert True, wird es Zeit, die Datei mit Close zu schlieSen. 


So lesen Sie eine Textdatei und zeigen ihren Inhalt in einem EditField an: 


Dim f as FolderItem 

Dim stream as TextInputStream 
f=GetOpenFolderItem("text/plain") 
If f<> Nil Then 

stream=f .OpenAsTextFile 
EditFieldl.text=stream.ReadAl1() 
stream.Close 

End if 


Da ReadAll einfach den kompletten Inhalt der Datei einliest, konnte dies bei einer grofSen Datei zu Speichermangel ftih- 


ren, je nachdem, wieviel Speicher der Benutzer Ihrer Anwendung zugeordnet hat. Behalten Sie das immer im Hinter- 
kopf, wenn Sie Readall einsetzen. 


Das nachste Beispiel liest Textzeilen aus einer Datei im Preferences-Ordner in eine ListBox ein: 


Dim f as FolderItem 
Dim stream as TextInputStream 
f = PreferencesFolder.child("My Apps Prefs") 
f f<>Nil Then 
stream = f.OpenAsTextFile 
While Not stream. EOF 
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ListBoxl.addrow stream. ReadLine 
Wend 
stream.Close 
End If 


Eine Textcodierung bestimmen 


Sofern Sie die Textdateien nur mit REALbasic-Applikationen lesen und schreiben, wird das angefiihrte Beispiel funktio- 
nieren. Werden aber Dateien von anderen Applikationen bearbeitet oder stammen gar von anderen Plattformen oder 
aus anderen Landern, werden Sie nicht umhin kommen, eine Textcodierung anzugeben. Andernfalls knnten die Zei- 
chen falsch interpretiert werden. Wenn Sie Text einlesen, sollten Sie die Codierung des Textes angeben. Dies konnen Sie 
mit Hilfe der Encoding-Eigenschaft der TextEncoding-Klasse. Hier ist das abgeanderte Beispiel, bei dem eine Textcodie- 
rung angegeben wird. 
Dim f as FolderItem 
Dim stream as TextInputStream 
f=GetOpenFolderItem( "text/plain" ) 
If f<> Nil Then 

stream=f .OpenAsTextFile 

Stream. Encoding=Encodings.MacRoman // MacRoman-Codierung angeben 

EditFieldl.text=stream.ReadAl1() 

stream.Close 
End if 
Das Encodings-Objekt bietet Zugriff auf alle verfiigbaren Codierungen. Verwenden Sie es immer dann, wenn Sie eine 
Codierung angeben miissen. Sie konnen die Codierung auch angeben, indem Sie diese als Parameter fiir die Read- und 
ReadAll-Methode angeben. 


Weitere Informationen finden Sie im Abschnitt ,,Arbeiten mit Textcodierungen“ auf Seite 249. 


Schreiben einer Textdatei 


Mit der AppendTolextFile-Methode kann man in eine Datei schreiben. Existiert die Datei noch nicht oder soll eine exis- 
tierende Datei tiberschrieben werden, verwendet man die CreateTextFile-Methode der Folderltem-Klasse. Diese Metho- 
den sind Funktionen, die wieder einen Stream liefern, der diesmal ein TextOutputStream ist. Die 
TextOutputStream-Klasse enthilt alle Funktionen, die man braucht, um in eine Textdatei zu schreiben. Der Text wird 
immer an das Ende einer existierenden Datei angehangt. 


Die Methode WriteLine hangt standardmafig ein Carriage-Return an das Ende jeder Zeile an. Mit der Eigenschaft 
Delimiter des TextOutputStreams kénnen Sie ein beliebiges anderes Zeichen festlegen. Am Ende des Schreibvorgangs 
schliefSen Sie die Datei mit der Methode ,,Close“. 


Hier zeigen wir, wie der Inhalt dreier EditFields in eine Textdatei geschrieben werden kann: 


Dim file As FolderItem 

Dim fileStream As TextOutputStream 
file=GetSaveFolderItem("plain/text","Mein Info") 
fileStream=file.CreateTextFile 
fileStream.WriteLine namefeld. Text 
fileStream.WriteLine addressefeld.Text 
fileStream.WriteLine telefonfeld. Text 
fileStream.Close 
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Festlegen einer Textcodierung 


Wie beim Lesen kann es auch beim Schreiben vorkommen, dass Sie eine spezifische Textcodierung angeben miissen. 
Wenn die Applikation, die diese Datei liest, eine bestimmte Codierung erwartet, sollten Sie den Text vor dem Schreiben 
in diese Codierung konvertieren. 


Dafiir rufen Sie, bevor Sie den Text schreiben, die ConvertEncoding-Funktion auf. Hier ein Beispiel, das einen Text in 
MacRoman codiert. 


Dim file As FolderItem 

Dim fileStream As TextOutputStream 
file=GetSaveFolderItem("plain/text","My Info") 
fileStream=file.CreateTextFile 

fileStream.Write ConvertEncoding(namefield.Text,Encodings .MacRoman) 
fileStream.Close 


Einschrankungen von Textdateien 


Auf Textdateien kann nur in sequentieller Folge zugegriffen werden. Wenn man also etwas aus der Mitte der Datei lesen 
mochte, muss man erst alle Informationen davor lesen, bis man dort angekommen ist. Will man etwas in der Mitte der 
Datei einfiigen, so muss man erst alles in die Datei schreiben, was davor kommt und dann den einzuftigenden Teil und 
als Abschluss den Rest der Daten. Es ist ferner unméglich, in eine Textdatei etwas zu schreiben, wenn aus dieser zugleich 
auch gelesen wird. Sollte so etwas in Ihrem Projekt vorkommen, miissen Sie zu bindren Dateien greifen. Informationen 
dazu siehe ,,Binare Streams“ auf Seite 297. 


Styled Text 


Unter Styled Text versteht man Textinformationen, die zusatzlich mit Angaben tiber Zeichensatze, Groen und Schriftar- 
ten versehen sind. 


Styled Text in einem Eingabefeld 


Mit einem Folderltem, das auf eine Datei mit Styled Text verweist, konnen Sie tiber die Methode OpenStyledEditField 
Daten aus dieser Datei lesen. Dieser Methode tibergeben Sie den Namen eines EditFields, bei dem die Eigenschaft 
Styled den Wert True haben muss: 


Dim f as FolderItem 
f=GetOpenFolderItem("SimpleText-Dateien") 
If f <> Nil Then 

f .OpenStyledEditfield EditField1l 

End if 


Speichern von Styled Text 


Wiederum tiber ein Folderltem schreiben Sie mit der SaveStyledEditField-Methode den Inhalt eines EditFields in eine 
Datei. Auch hier gilt wieder, dass die Eigenschaften Styled und MultiLine den Wert True haben miissen: 


Dim f as FolderItem 
f=GetSaveFolderItem("plain/text","Namenlos") 
If f <> Nil Then 

f.SaveStyledEditField EditField1l 

End if 
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Arbeiten mit StyledText-Objekten 


Eine andere Moglichkeit formatierten Text zu lesen und schreiben bietet StyledText-Klasse. Damit konnen Sie mit forma- 
tiertem Text arbeiten, der in keinem Zusammenhang mit einem EditField steht. Sie konnen die Formatierung bearbeiten 
und es auf Ihrer Festplatte speichern, um es spater zu verwenden. 


Sie arbeiten mit einem StyledText wie mit einer Folge von StyleRun-Objekten. Der StyleRun-Eintrag in der Sprachrefe- 
renz zeigt Ihnen, wie Sie mit Hilfe eines BinaryStream ein StyledText-Objekt speichern. Diesem Ansatz zufolge speichern 
Sie die StyleRun-Objekte in einem MemoryBlock und schreiben dann diesen Speicherblock mit Hilfe der Write-Methode 
der BinaryStream-Klasse auf die Festplatte. Flir weitere Informationen lesen Sie bitte den Eintrag in der Sprachreferenz. 


Verwenden von Bilddateien 


Auch zum Offnen und Speichern von Bitmaps und Vektorgrafiken hat REALbasic entsprechende Funktionen parat. Unter 
Mac OS unterstiitzt es Vektorgrafiken und gerasterte PICT-Dateien, unter Windows das .bmp-Format (Bitmap) und das 
.emf-Format (Extended Metafile Format). Bevor man eine PICT-Datei 6ffnen oder speichern kann, bendotigt man ein Fol- 
derltem, das diese Datei reprasentiert. Die Folderltem-Methoden OpendAsPicture, SaveAsPicture und SaveAsJPEG stellen 
die benGtigten Routinen bereit. Wenn Sie mit einer Vektorgrafik-Datei arbeiten, kénnen Sie die OpenAsVectorPic- 
ture-Methode der Folderltem-Klasse verwenden. REALbasic versucht die Objekte der Datei in editierbare 
Object2D-Objekte umzuwandeln. 


Speichern von Bildern 


Um ein Bild in einer PICT-Datei abzuspeichern, benotigen Sie ein Folderltem, das eine neue oder eine bereits vorhan- 
dene PICT-Datei reprasentiert. Als nachstes rufen Sie die SaveAsPicture-Methode des Folderltems auf und tibergeben 
dieser das Bild, das gespeichert werden soll. Im folgenden Beispiel wird das Backdrop-Bild eines Canvas-Steuerelements 
in einer Datei gespeichert, nachdem der Anwender in einer SaveAs-Dialogbox den Dateinamen festgelegt hat. 

Dim f as FolderItem 

f=GetSaveFolderItem("image/x-pict","Namenlos") 

If f <> Nil Then 


f .SaveAsPicture Canvasl.backdrop 
End If 


Um das Bild im JPEG-Format zu speichern, ersetzen Sie den ersten Parameter fiir GetSaveFolderltem durch _,image/ 
jpeg". 

Die SaveAsPicture-Methode hat einen zweiten optionalen Parameter, tiber den Sie das Format der zu speichernden Datei 
festlegen k6nnen. Sie k6nnen sich entweder ftir eine Vektorgrafik- oder ein Bitmap-Format entscheiden. Sie kénnen 
aber auch ein Meta-Format angeben. In der folgenden Tabelle sind die Codes fiir die Meta-Formate aufgelistet: 


Tabelle 33. Codes und Beschreibung der Meta-Formate der SaveAsPicture-Methode 


Wert Klassenkonstante Beschreibung 


0 SaveAsMostCompatible Das gebrauchlichste Format der jeweiligen Plattform (Mac: PICT, Win32: BMP) 

1 SaveAsMostComplete — Format mit der héchsten Wahrscheinlichkeit fiir das Behalten aller 
Vektorinformationen (Mac: PICT, Win32: EMF) 

2 SaveAsDefault DefaultVector oder DefaultRaster, abhangig von den Bilddaten (Mac: PICT, Win32 
Vector: EMF, Win32 Raster: BMP 

3 SaveAsDefaultVector Standard-Vektorformat der jeweiligen Platform (Mac: PICT, Win32: EMF) 


4 SaveAsDefaultRaster Standard-Rasterformat der jeweiligen Plattform (Mac: Raster PICT, Win32: BMP) 
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Sie k6nnen im Code statt der numerischen Werte auch die Konstanten verwenden. Weitere Informationen zum Spei- 
chern im Vektor- oder Raster-Format finden Sie in der Sprachreferenz im Abschnitt tiber die Folderltem-Klasse. 


Das Speichern eines Bildes, das in die Graphics-Eigenschaft eines Canvas-Steuerelements gezeichnet wurde, ist etwas 
komplizierter. Das kommt daher, dass die Eigenschaft Graphics kein PICT enthalt. Daher muss man dem Fenster zusitz- 
lich eine Picture-Eigenschaft verpassen. Alles, was nun in der Eigenschaft Graphics gezeichnet wird, muss ebenfalls in 
der Eigenschaft Picture gezeichnet werden. Dann kann das Bild auch tiber die SaveAsPicture-Methode gespeichert wer- 
den. Die Eigenschaft Picture, die Sie dem Fenster neu zugeordnet haben, muss zuerst mit einem leeren Bild belegt wer- 
den. Das erledigt die Funktion NewPicture am besten im Open-Event-Handler des Fensters. In unserem Beispiel ist die 
Eigenschaft Picture der Variablen p zugewiesen: 

p=newpicture(canvasl.width,canvasl].height, 32) 


Im MouseDown-Event des Canvas-Steuerelements wird ein schwarzer Punkt gemalt, wenn der Benutzer mit der Maus 
klickt. Mit folgenden Zeilen tibernimmt man diese Aktion auch in die Picture Eigenschaft p: 


e.Graphics.Pixel(x,y)=Rgb(0,0,0) 
p.Graphics.Pixel(x,y)=Rgb(0,0,0) 


Die Picture-Eigenschaft kann als PICT-Datei gesichert werden: 


Dim f as FolderItem 
f=GetSaveFolderItem("image/x-pict","Namenlos") 
f f <> Nil Then 

f.SaveAsPicture p 

End if 


Offnen von Bilddateien 


Um eine Bilddatei zu 6ffnen, bendtigen Sie das Folderltem der PICT- oder .bmp-Datei des Bildes. Dann kénnen Sie das 
Bild mit der OpenAsPicture-Methode des Folderltems 6ffnen. 


Folgender Beispielcode zeigt den ,,Datei Gffnen“-Dialog, in dem der Anwender eine PICT- oder .bmp-Datei auswahlen 
kann, die dann der Backdrop-Eigenschaft eines Canvas-Steuerelements zugewiesen wird. 

Dim f as FolderItem 

f=GetOpenFolderItem("image/x-pict") 

If f <> Nil Then 


Canvasl.Backdrop=f .OpenAsPicture 
End if 


Dim f as FolderItem 
f=GetOpenFolderItem("image/x-pict”,” image/x-bmp” ) 
If f <> Nil Then 
Canvasl.Backdrop=f .OpenAsPicture 
End if 
Wenn es sich bei der Datei um eine Vektorgrafik handelt, konnen Sie zum Umwandeln der Dateiinformationen in fiir 
REALbasic verwertbare Vektorobjekte anstelle der OpenAsPicture-Methode die OpenAsVectorPicture-Methode aufrufen. 
Diese Option steht unter Mac OS fiir Vektor-PICT-Dateien und unter Windows fiir EMF-Dateien zur Verfiigung. 


Die Originaldatei enthalt méglicherweise Objekte, fiir die es keine Entsprechung in REALbasic gibt. REALbasic versucht 
in diesem Fall, das bestmGgliche Ergebnis bei der Umwandlung zu erzielen. In Abhangigkeit der Eigenschaften der Origi- 
naldatei kann es jedoch vorkommen, dass Informationen verloren gehen. 

PICT-Dateien unterstiitzen Rechtecke, Linien, Ellipsen, RoundRects, Polygone, Text, Pixmaps und Bogen, die keiner 
Rotation ausgesetzt waren. 

Extended Metafile-Dateien (.emf) unterstiitzen Rechtecke, Linien, Ellipsen, RoundRects, Polygone, Text, Pixmaps und 
Bogen, die keiner Rotation ausgesetzt waren. 
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.emf-Dateien werden in der Originalgrd&e wiedergegeben, die fiir die Bildschirmdarstellung meistens ungeeignet ist. 
Aller Wahrscheinlichkeit nach werden Sie vor dem Anzeigen der Datei die GrdSe herunterskalieren miissen 
(picl.objects.scale=Skalierungsfaktor). Ein Skalierungsfaktor von 0.045 ist ein guter Wert. 


Verwendung von Sounddateien 


REALbasic kann Mac- und WAV-Sounddateien 6ffnen, aber nicht speichern. Mit der OpenAsSound-Methode des Folder- 
Items einer Sounddatei kann diese wie folgt gedffnet und abgespielt werden: 

Dim f as FolderItem 

Dim s as Sound 

f=GetFolderItem( "Quack" ) 

If f<> Nil Then 

s=f .OpenAsSound 

s.Play 

End if 


Tone, die in einer snd-Resource gespeichert sind, lassen sich ebenfalls verwenden. Mehr dazu siehe ,Lesen von Resour- 
cen“ auf Seite 301. 


Verwenden von QuickTime-Movie-Dateien 


Mit der OpenAsMovie-Methode des Folderltems eines QuickTime-Films lasst sich ein Film wie folgt abspielen: 
Dim f as FolderItem 

Dim m as Movie 

f=GetOpenFolderItem("video/quicktime" ) 

If f<> Nil Then 

m=f .OpenAsMovie 

moviePlayerl .Movie=m 

moviePlayerl.Play 

End if 


Wenn Ihr Programm einen bestimmten QuickTime-Film ben6tigt, kGnnen Sie ihn ins Projektfenster draggen und miis- 
sen nicht GetOpenFolderltem oder GetFolderltem verwenden. 


Wenn Sie den Film innerhalb von REALbasic bearbeiten méchten, miissen Sie ihn als EditableMovie offnen. Um den Film 
in einem MoviePlayer wiederzugeben, miissen Sie ihn der Movie-Eigenschaft des MoviePlayers zuweisen. 


Das folgende Beispiel Gffnet einen Film als EditableMovie und zeigt ihn anschlie&end in einem MoviePlayer-Steuerele- 
ment names ThePlayer an. 
Dim f As FolderItem 
Dim theEMovie as EditableMovie 
f=GetOpenFolderItem("video/quicktime" ) 
If f<>Nil and f.exists then 
theEMovie=f.OpenEditableMovie 
If theEMovie<>Nil then 
ThePlayer.movie=theEMovie 
end if 
end if 


Mit den Methoden der EditableMovie-Klasse konnen Sie: 
© ein Segment in einem EditableMovie definieren, 


e das Segment in die Zwischenablage ausschneiden oder kopieren, 
© ein Segment in den aktuellen Film einftigen, 
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© dem aktuellen Film ein anderes Filmsegment anhangen, 

© ein Segment an einer bestimmten Position im aktuellen EditableMovie einfiigen, 

© neue Sound- und/oder Video-Spuren anlegen, 

© die Videospur skalieren. 

Sie kénnen die vorgenommenen Anderungen nach Beendigung automatisch oder durch Aufruf der Commit- 
Changes-Methode speichern. Weitere Informationen zu Methoden, die Sie im Zusammenhang mit QuickTime-Filmen 
verwenden k6nnen, finden Sie in der Sprachreferenz im Abschnitt tiber EditableMovies. 


Die Arbeit mit Binardateien 


In Binardateien werden Daten im Bindrformat und nicht als Text gesichert. Die Zahl 30000 wiirde als ASCII-Text ftinf Zei- 
chen (oder auch Bytes) benotigen, aber in einem Binarformat wiirde sie als Short Integer nur zwei Bytes belegen. 


Im Unterschied zu Textdateien ist es mOglich, auf eine Bindrdatei gleichzeitig lesend und schreibend zuzugreifen. Auch 
der Direktzugriff auf eine bestimmte Position der Datei ist mdglich, ohne dass alle davor stehenden Daten gelesen wer- 
den ntissen. 


Die meisten Programme sichern ihre Daten im Binarformat. Um eine solche Datei lesen zu k6nnen, muss man wissen, 
wie die Daten in der Datei organisiert sind. Wurde die Datei von Ihrem eigenen Programm erzeugt, ist das kein Problem. 
Kommen die Daten von anderen Programmen, ist es schon schwieriger. Einige Formate werden verdffentlicht, wie bei- 
spielsweise das PICT-Format. Die meisten Softwarehersteller jedoch dokumentieren nicht 6ffentlich, wie die Dateien, 
die ihre Software erzeugt, aufgebaut sind. 


Binare Streams 


Daten, die aus einer Binardatei kommen, flieSen iiber einen bindren Stream. BinaryStream ist eine REALbasic-Objekt- 
klasse, die den Informationsfluss zwischen einem Folderltem und der von diesem Folderltem referenzierten Datei repra- 
sentiert. Anders als bei TextInputStream und TextOutputStream, bei denen die Daten jeweils nur in eine Richtung 
ef6rdert werden k6nnen, ldsst ein BinaryStream sich zum Lesen und Schreiben von Daten verwenden. Daher muss 
man dem BinaryStream extra mitteilen, wenn man ihn nur zum Lesen verwenden will, so dass die Datei fir Schreibzu- 
griffe anderer Programme weiterhin zur Verftigung steht. 


BinaryStreams konnen sowohl bestimmte Datentypen schreiben (wie String, Short Integer, Long Integer, Bytes). Sie 
konnen aber auch unformatierte Binardaten schreiben. 


Lesen einer Binardatei 


Mit einem Folderltem und der OpenAsBinaryFile-Methode bekommen Sie einen BinaryStream, aus dem Sie mit den 
Methoden Read, ReadByte, ReadLong, ReadPString und ReadShort Daten lesen kénnen. Der BinaryStream merkt sich 
jeweils auch die Position innerhalb der Datei in der Eigenschaft Position. Durch Andern dieser Eigenschaft kénnen Sie an 
beliebige Stellen in der Datei springen. 


Im folgenden Beispiel wird eine Datei gedffnet und eine Reihe von Zeichenketten (Strings) wird in eine ListBox eingele- 
sen. Beachten Sie, dass der OpenAsBinary-Methode ein False tibergeben wird, um die Datei im Read-Only-Modus zu off- 
nen, also nur lesend auf die Datei zuzugreifen. In einer Schleife werden die Daten gelesen, bis die Eigenschaft EOF den 
Wert True erreicht: 
Dim f as FolderItem 
Dim stream as BinaryStream 
f=GetOpenFolderItem("MeinDateiTyp" ) 
If f<> Nil Then 

ListBox1.DeleteAl1Rows 
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stream=f .OpenAsBinaryFile(False) 
do 
ListBoxl.AddRow stream. ReadPString 
ListBoxl.Cell(ListBoxl.ListCount-1,1)=stream.ReadPString 
Loop Until stream. EOF 
stream.Close 
End if 


Diese Schleife ware etwa 25% schneller, wenn es sich um eine For...Next-Schleife handeln wiirde. Dazu miisste man 
aber schon vorher wissen, wieviele Zeilen gelesen werden miissen. Ware in den ersten vier Bytes der Datei ein Long 
Integer-Wert untergebracht, der die Anzahl der Zeilen in der Datei angibt, dann kénnte man so vorgehen: 


Dim f as FolderItem 

Dim stream as BinaryStream 

Dim count,i as Integer 
f=GetOpenFolderItem("MeinDateiTyp") 

If f<> Nil Then 

ListBoxl.DeleteAl1Rows 

stream=f .OpenAsBinaryFile(False) 

count=stream. ReadLong 

For i=l to count 

Listboxl.AddRow stream. ReadPString 
Listboxl.Cell(ListBoxl.Listcount-1,1)=stream.ReadPString 
ext 
stream.Close 
End if 


Unter Umstanden miissen Sie auch beim Lesen eines BinaryStreams die Codierung der Zeichen berticksichtigen. Dazu 
k6nnen Sie der Read- und ReadPString-Methode die Codierung als optionalen Parameter tibergeben. Verwenden Sie 
dazu das Encodings-Objekt. Weitere Informationen finden Sie im Abschnitt ,,Arbeiten mit Textcodierungen“ auf 
Seite 249. 


Schreiben einer Binardatei 


Mit einem Folderltem und der Methode ,,OpenAsBinaryFile“ kann eine existierende Datei geoffnet werden. Mit Create- 
BinaryFile wird eine neue Datei angelegt. Beide Methoden liefern einen BinaryStream zurtick, tiber welchen mit den 
Methoden Write, WriteByte, WriteLong, WritePString und WriteShort Daten in die Datei geschrieben werden konnen. 
Der BinaryStream merkt sich in der Eigenschaft Position auch die Position innerhalb der Datei. Durch Andern dieser 
Eigenschaft konnen Sie an eine beliebige Position in der Datei springen. 


Sind die Schreibzugriffe abgeschlossen, schlieen Sie die Datei mit der Close-Methode des BinaryStream. 


Im Beispiel wird der Inhalt zweier Spalten einer Listbox in eine Datei geschrieben und dann wird die Datei geschlossen. 
Dieses Beispiel erzeugt die Datei, die im obigen Beispiel mit der For. ..Next-Schleife eingelesen wurde: 


Dim f as FolderItem 

Dim 7 as Integer 

Dim stream as BinaryStream 
f=GetSaveFolderItem("MeinDateiTyp","Namenlos") 
If f<> Nil Then 

stream=f .CreateBinaryFile("myFileType") 
stream.WriteLong ListBoxl.ListCount 

For i=0 to ListBoxl.Listcount-1 
stream.WritePString ListBoxl.List(i) 
stream.WritePString ListBox1.Cel1(i,1) 
Next 

stream.Close 
End if 
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Virtuelle Volumes 


Bis zu diesem Punkt drehte es sich in diesem Kapitel um herk6mmliche Schreibtisch-Dateien und -Ordner, die von jeder 
Anwendung, die fiir einen bestimmten Dateityp ausgelegt ist, erstellt, ausgelesen oder verandert werden konnen. REAL- 
basic ermdglicht es Ihnen zusatzlich, eine besondere Art von Dokument, das mehrere verschiedene Dateitypen vereinen 
kann, anzulegen und zu pflegen. Unter diesem Gesichtspunkt handelt es sich dabei eher um ein Volume als um eine ein- 
zelne Datei. Aus diesem Grunde spricht man auch von ,virtuellen Volumes‘. Ein virtuelles Volume kann von einer REAL- 
asic-Anwendung angelegt werden. Die Anwendung kann auf das Volume schreiben und es auslesen. Virtuelle Volumes 
werden von allen Plattformen unterstiitzt. So kénnen Sie beispielsweise auf einem Mac ein virtuelles Volume anlegen 
und es dann unter Windows auslesen, bestehende Dateien verandern oder zusatzliche Dateien erzeugen. 


Uber die VirtualVolume-Klasse konnen Sie eine Hierarchie von ,virtuellen“ Dateien innerhalb einer tatsdchlich vorhande- 
nen Datei anlegen und pflegen. Die VirtualVolume-Klasse unterstiitzt das Lesen und Schreiben von Text- und 
Binary-Streams. Das bedeutet, dass Sie iiber die TextOutputStream- und die BinaryStream-Klassen Text- und 
Binar-Dateien erzeugen k6nnen. Das bedeutet aber auch, dass die SaveAsPicture- und SaveStyledEditField-Methoden 
der Folderltem-Klasse mit virtuellen Volumes nicht funktionieren. 


Die Folderltem-Klasse besitzt zwei Methoden und eine Eigenschaft ftir das Arbeiten mit virtuellen Volumes. Verwenden 
Sie die CreateAsVirtualVolume- und die OpenAsVirtualVolume-Methoden, um ein virtuelles Volume anzulegen und es zu 
6ffnen. Falls sich ein bestimmtes Folderltem auf einem virtuellem Volume befindet, enthdlt seine VirtualVolume-Eigen- 
schaft das virtuelle Volume. 


Wenn Sie einmal ein virtuelles Volume angelegt haben, k6nnen Sie die Root-Eigenschaft auslesen und das Wurzelver- 
zeichnis (root) mit den gleichen Folderltem-Methoden, die Sie auch fiir ,echte“ Dateien einsetzen, ansteuern. Virtuelle 
Volumes unterstiitzen keine Resource Forks. 


Der folgende Code legt ein virtuelles Volume an und ruft die Root-Eigenschaft auf. Wenn Sie einmal das Wurzelverzeich- 
nis (root) des virtuellen Volumes kennen, kénnen Sie mit Hilfe der TextOutputStream- und BinaryStream-Klassen 
Dateien relativ zum Wurzelverzeichnis anlegen. 


Dim f as FolderItem 

Dim v as VirtualVolume 

v=New VirtualVolume 
f=GetFolderItem(““).Child(“VV“) 
f f<>Nil then 

v=f .CreateVirtual Volume 

if v.Root<> Nil then 

MsgBox v.Root.Name 

End if 

End if 


Verwenden von Macintosh Resources 


Alle Macintosh-Dateien (inklusive der Programme, die ja im Grunde auch nur Dateien sind) bestehen aus zwei Teilen, 
die Forks genannt werden. Der Data-Fork enthalt die Daten im applikationsspezifischen Format und der Resource-Fork 
enthalt formatierte Informationen zu der Datei, wie Icons, Tone, Meniileisten, Bilder, Listen von Strings etc. 


REALbasic erlaubt das Lesen und Schreiben des Resource-Fork. Auch dies wird tiber ein Folderltem realisiert. Mehr zu 
diesem Thema bietet zum Beispiel das Buch Inside Macintosh: Resources von Addison-Wesley (englisch). 


REALbasic untersttitzt das Arbeiten mit dem Resource-Fork nur auf der Macintosh-Plattform. Die Beschreibung und die 
Bespiele in diesem Abschnitt setzen voraus, dass das Programm auf einem Macintosh lduft. Wenn Ihr Programm Macin- 
tosh-Resources verwenden soll, k6nnen Sie die Konstanten TargetWin32 oder TargetMacOS verwenden, um sicherzu- 
stellen, dass das Programm auf einem Macintosh Iduft, bevor Sie auf den Resource-Fork zugreifen. Ausnahme: Es ist 
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méoglich, benutzerdefinierte Mauszeiger in Ihr Programm einzubinden, indem Sie die CURS-Resource verwenden und 
auf diese in der erzeugten Windows-Applikation zugreifen. Dies wird im Abschnitt ,,Benutzerdefinierte Maus-Cursor in 
Windows-Applikationen“ auf Seite 301 beschrieben. 


Offnen des Resource-Forks 


Mit dem Folderltem und der Methode OpenResourceFork erhalt man ein Objekt der Klasse ResourceFork oder ,,Nil“, 
wenn die Datei keinen Resource-Fork enthiilt (z.B. weil sie von einem PC kommt). 


Das Beispiel ermittelt, wie viele Resource-Objekte in einem Resource-Fork enthalten sind: 


Dim f as FolderItem 
Dim rf as ResourceFor 
f=GetOpenFolderItem("any") 
If f <> Nil Then 

rf=f .OpenResourceFor 
If rf=Nil Then 

Beep 

MsgBox "Die Datei hat keinen Resource-Fork." 
Else 
MsgBox "Die Datei hat"+str(rf.TypeCount)+" Resource-Tpyen." 
End if 

End if 


Der Dateityp ,any“, der an die GetOpenFolderltem-Dialogbox tibergeben wird, wurde im Dateitypen-Dialog zuvor defi- 
niert und verwendet den String ,,???“ fiir Type und Creator. Die Fragezeichen passen auf jeden Type- oder Creator-Code. 


Anlegen eines Resource-Fork 


Bevor man in einen Resource-Fork schreiben kann, muss die Datei zunachst einen haben. Uber OpenResourceFork stellt 
man daher zunichst fest, ob die Datei einen Resource-Fork hat. Ist das nicht der Fall, kann er mit CreateResourceFork 
angelegt werden. Das Beispiel zeigt, wie das geht: 
Dim f as FolderItem 
Dim rf as ResourceFork 
f=GetOpenFolderItem("any") 
If f <> Nil Then 
rf=f .OpenResourceFork 
If rf=Nil Then 
rf=f.CreateResourceFork("any") 
End if 
End if 


Einem Projekt einen Resource-Fork hinzufiigen 


Sie konnen einem REALbasic-Projekt einen Resource-Fork hinzufiigen, indem Sie eine Resource-Datei in das Projekt- 
fenster draggen. REALbasic erkennt eine Resource-Datei am Datei-Typ ,,rsrc“. Sie konnen beliebig viele Resource-Dateien 
in Ihr Projekt einbinden. Die Resourcen aller Resource-Dateien werden in die erzeugte Applikation eingebunden. Im 
Falle eines Konflikts tiberschreiben spatere Resource-Dateien friihere, und zwar in der Reihenfolge, in der sie im Projekt- 
fenster erscheinen. Folgendes Beispiel 6ffnet den Resource-Fork der Applikation: 


Dim rf as ResourceFork 
rf=App.ResourceFork 
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Unterstutzte Resource-Typen 


REALbasic kennt Funktionen fiir PICT-, CICN-, CURS-, und snd-Resourcen. Mit der Methode AddPicture kann eine 
PICT-Resource eingefiigt werden und mit GetPicture oder GetNamedPicture kann man PICT-Resourcen aus einem 
Resource-Fork lesen. Mit GetCicn greift man auf die Colorlcon-Resource zu. Tone kann man aus der snd-Resource tiber 
GetSound erhalten. Jede andere Form von Resource-Daten kann in Form von bindren Daten aus dem Resource-Fork 
geholt bzw. in ihn geschrieben werden. Sie mtissen dann aber wissen, wie diese Daten aufgebaut sind, damit ihr Pro- 
gramm sie interpretieren kann. 


Lesen von Resourcen 


Die ResourceFork-Klasse besitzt Methoden, um Daten aus Resourcen vier verschiedener Typen zu lesen. Sie konnen 
PICT-Resourcen mit den Methoden GetPicture und GetNamedPicture lesen. Sie konnen ein Farb-Icon-Picture durch Auf- 
ruf der Methode GetCicn erhalten. Sie konnen ein grofses (32*32) Icon tiber die GetIcl-Methode und ein kleines (16*16) 
Icon tiber die GetIcs-Methode bekommen. Das Beispiel zeigt eine Picture-Resource in einem ImageWell an: 


Me. Image=App. ResourceFork.GetPicture(128) 
Auf die gleiche Art konnen Sie GetCicn, GetIcl und GetlIcs verwenden. 
Sie konnen Sounds aus ,,snd “-Resourcen mit der GetSound-Methode der ResourceFork-Klasse laden. 


Lesen benutzerdefinierter Maus-Cursor 


Verwenden Sie GetCursor, um der MouseCursor-Eigenschaft der Applikation, einem Fenster oder einem Steuerelement 
einen benutzerdefinierten Maus-Cursor zuzuweisen. Als Beispiel weist folgender Code im MouseEnter-Event-Handler 
eines Fensters der MouseCursor-Eigenschaft des Fensters einen benutzerdefinierten Maus-Cursor zu: 


self.MouseCursor=App. ResourceFork.GetCursor(128) 


Diese Zeile bewirkt, dass REALbasic den benutzerdefinierten Maus-Cursor immer dann anzeigt, wenn der Mauszeiger 
den Bereich des Fensters beriihrt. Soll sich der Maus-Cursor andern, wenn sich die Maus tiber einem Steuerelement in 
diesem Fenster befindet, kénnen Sie folgende Zeile im MouseEnter-Event-Handler des Steuerelements verwenden: 


self.MouseCursor=App. ResourceFork.GetCursor(129) 


und dann den benutzerdefinierten Maus-Cursor des Fensters mit folgender Zeile im MouseExit-Event-Handler des Steu- 
erelements wiederherstellen: 


self.MouseCursor=App. ResourceFork.GetCursor(128) 

Beachten Sie, dass diese Zeilen der MouseCursor-Eigenschaft des Steuerelements keinen Cursor zuweisen, sie 4andern 
nur die Zuweisung zum Elternfenster des Steuerelements. 

Hinweis: Wenn das Elternfenster des Steuerelements oder die Applikation selbst eine benutzerdefinierte MouseCur- 
sor-Eigenschaft besitzt, wird die MouseCursor-Eigenschaft des Steuerelements ignoriert. 

Der ganzen Applikation kénnen Sie einen benutzerdefinierten Cursor zuweisen, indem Sie folgenden Code in den 
Open-Event-Handler des App-Objekts eintragen: 

MouseCursor=App. ResourceFork.GetCursor(128) 


Dies fiihrt dazu, dass die REALbasic-Applikation die ganze Zeit diesen benutzerdefinierten Cursor verwendet und die 
MouseCursor-Eigenschaften aller Fenster und Steuerelemente der Applikation ignoriert werden. 


Benutzerdefinierte Maus-Cursor in Windows-Applikationen 


Sie konnen CURS-Resourcen dazu verwenden, benutzerdefinierte Maus-Cursor in erzeugten Windows-Applikationen 
zuzuweisen. Dies ist derzeit der einzige Fall, in dem Resourcen in Programmen, die fiir Windows erzeugt wurden, unter- 
stiitzt werden. Die Beziehungen zwischen den MouseCursor-Eigenschaften der Application, der Fenster und der Steuer- 
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elemente sind die gleichen wie bei Macintosh-Applikationen Sie mtissen die Resource-Datei jedoch auf eine bestimmte 
Weise erzeugen. Diese Technik empfehlen wir auch fiir Macintosh-Applikationen. 


Fiir jeden benutzerdefinierten Cursor, den Sie im Projekt verwenden mochten, miissen Sie eine eigene Resource-Datei 
erzeugen. Jede Resource-Datei darf nur eine CURS-Resource beinhalten. Normalerweise weisen Sie den benutzerdefi- 
nierten Cursor der ID 128 zu. Hier ein Beispiel: 


0 == GsstromSchwamm = 8] 


128 


Danach draggen Sie alle diese Resource-Dateien in Ihr Projekt. Diese speziellen Resource-Dateien erscheinen im Pro- 
jektfenster mit einem Cursor-Icon wie in folgender Abbildung: 


o Namentos =i} =| 
i Fenstert 
& Meni 
® Stift 
® Radierer 
» Schwamm 


Sie konnen dann auf die benutzerdefinierten Cursor-Ressourcen tiber ihre Namen zugreifen. Als Beispiel andert folgen- 
der Befehl im MouseEnter-Event-Handler eines Steuerelements den Mauszeiger in den Schwamm-Cursor, wenn die 
Maus den Bereich des Steuerelements betritt: 

Self .MouseCursor=Sponge 


Sie sollten dann den alten Cursor mit dem passenden Befehl im MouseExit-Event-Handler des Steuerelements wieder- 
herstellen. 


Lesen von anderen Resourcen 


Um Daten aus anderen Resourcen zu lesen, miissen Sie das Format der Resource kennen. Wenn Sie z.B. die 
STR#-Resource lesen mdchten, kGnnen Sie dies mittels der GetResource-Methode der ResourceFork-Klasse tun. Sie 
erhalten dann die Anzahl der Bytes, die die Resource mit der genannten ID (in diesem Fall STR#) enthiilt. Wenn Sie 
dann beriicksichtigen, dass die ersten zwei Bytes der STR#-Resource die Anzahl der Strings in der Resource reprasentie- 
ren und die Strings im Pascal-Format vorliegen (erstes Byte ist die Lange des Strings), dann konnen Sie schon etwas sinn- 
volles damit anstellen. 


Wenn Sie Ihre Applikation erzeugen, konnen Sie Versionsinformationen tiber die Applikation in den ,,Applikation erzeu- 
gen‘-Dialog eingeben. Diese Informationen werden in einer ,,vers“-Resource gespeichert, die Teil Ihrer Applikation wird. 
Eine Applikation kann auf die ,vers“-Resource mit der GetResource-Methode der ResourceFork-Klasse zugreifen. Welche 
Informationen in die ,vers-Resource geschrieben werden, erfahren Sie im Abschnitt Versions-Information“ auf 
Seite 390. 


Schreiben von Resourcen 


Mit der Methode AddPicture legt man ein neues Bild in eine vorhandene PICT-Resource. Mit der AddResource-Methode 
legt man neue Resourcen an und mit RemoveResource kann eine bestimmte Resource geléscht werden. Um Verande- 
rungen an Nicht-PICT-Resourcen vorzunehmen, holen Sie sich zunachst die Daten tiber GetResource, léschen diese 
dann mit RemoveResource und hangen die Daten erneut mittels AddResource an. Mehr Information dartiber siehe 
ResourceFork in der Sprachreferenz. 


Uber den Schreibtisch gedffnete Dateien 303 


Uber den Schreibtisch gedffnete Dateien 


Fiihrt der Benutzer einen Doppelklick auf eine Datei aus, deren Creator-Code mit dem Creator-Code Ihres Programms 
iibereinstimmt, oder zieht er die Datei auf das Icon Ihres Programms, wird er zurecht erwarten, dass dann Ihr Programm 
gestartet und die Datei gedffnet wird. Um dies zu realisieren, bendtigt man eine neue Klasse, die auf der Applica- 
tion-Klasse beruht. Diese Klasse steht fiir Ihre Anwendung und empfangt Informationen, wenn der Benutzer einen Dop- 
pelklick auf eine Datei mit Ihrer Datei-Kennung ausfiihrt. Die Application-Klasse stellt daftir den Event-Handler 
OpenDocument zur Verfiigung, der in diesem Fall ausgeftihrt wird. Er bekommt als Parameter ein Folderltem, das die 
Datei, auf die doppelt geklickt wurde, reprasentiert. Gehen Sie so vor: 


1. Wenn Thr Projekt noch keine Application-Klasse verwendet, wahlen Sie Datei/Neue Klasse. 


Hinweis: Jedes Projekt, das tiber die Projektvorlage angelegt wird, enthalt bereits eine auf der Application-Klasse 
beruhende App-Klasse. 


2. Im Eigenschaftenfenster wahlen Sie im Popup Super den Typ Application. 

3. Als Name geben Sie dort App ein. 

4. Klappen Sie im Code-Editor die Event-Liste auf. 

5. Klicken Sie auf das Event OpenDocument. 

6. Geben Sie hier den Code zum Offnen des doppelt angeklickten Dokuments ein. 


REALbasic behandelt eine Datei, die auf das Icon Ihrer Anwendung , fallengelassen“ wird, genauso wie eine Datei, auf die 
der Benutzer doppelt geklickt hat. 


Anlegen neuer Dateien 


Startet ein Benutzer Ihr Programm, ohne es tiber eine Datei zu offnen, kann es sein, dass Sie gern automatisch ein neues 
Dokument bereitstellen wiirden. Dazu k6nnen Sie den Event-Handler ,NewDocument* der App-Klasse verwenden. 
Unter Macintosh wird dieser auch ausgefiihrt, wenn die Anwendung ein OpenApplication-AppleEvent (oapp) erhalt, das 
ausgeldst wird, wenn AppleScript dem Finder sagt, dass Ihr Programm gestartet werden soll. 


Den NewDocument-Event-Handler k6nnen Sie mit ,NewDocument“ aufrufen, wodurch Sie nur an einer Stelle die néti- 
gen Schritte ablegen miissen, die ftir das Erzeugen eines neuen Dokuments abgearbeitet werden miissen. 
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capitis Wiederverwendbare Objekte 
durch Klassen 


Klassen dienen als Vorlagen ftir Objekte, so wie beispielsweise die im Projektfenster aufgefiihrten Fenster als Vorlagen 
fiir die Fenster in Ihrem Programm verwendet werden. Dieses Kapitel wird Ihnen die Vorziige von Klassen naherbringen 
und zeigen, wie man sie verandert und wie man selbstdefinierte Bedienelemente mit Klassen anlegt. 
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Definition von Unterklassen 
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Selbstdefinierte Objektverkniipfungen 


Die Vorziige von Klassen 


Wiederverwendbarer Code 


Wird das Verhalten eines PushButtons programmiert, dann kann der dazu geschriebene Programmteil nur ftir diesen 
PushButton verwendet werden. Will man dieses Programmstiick auch fiir einen anderen PushButton verwenden, dann 
muss man es kopieren und so anpassen, dass es den Namen des neuen PushButtons enthalt, sofern es sich vorher auf 
den Original-PushButton bezogen hat. 

Fiir Klassen hingegen wird dieses Programmstiick nur einmal definiert. Die Referenz auf das eigentliche Objekt (hier 
eben ein PushButton) erfolgt symbolisch. Das gleiche Programmstiick kann so ohne Anderung immer wieder verwendet 
werden. Wenn Sie eine Klasse auf Basis eines PushButton-Steuerelements erzeugen und dann dieser Klasse Ihren Code 
hinzuftigen, besitzt jede Instanz dieser selbstdefinierten Klasse diesen Code. 


Kleinere Projekte und Programme 


Weil die Klassen es erlauben, Programmteile einmal abzulegen und dann innerhalb des Projektes immer wieder zu ver- 
wenden, wird das Gesamtprogramm ktirzer und braucht spater wahrscheinlich auch weniger Speicher. 
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Erleichterte Programmwartung 


Ktirzere Programme bedeuten auch immer weniger Wartungsaufwand. Wenn Sie ein ahnliches Programmstiick an meh- 
reren Stellen im Programm abgelegt haben, dann miissen Sie das immer im Hinterkopf behalten, wenn Sie sich an die 
Behebung von Fehlern machen oder das Projekt verindern. Ist der Programmteil aber nur einmal vorhanden, werden 
Sie logischerweise auch erheblich weniger Zeit mit Anderungen verbringen, weil die Suche nach Stellen im Programm, 
an denen dhnliche Teile verwendet wurden, entfallt. Die Anderung der Klasse wirkt sich sofort auf alle Stellen aus, an 
denen sie verwendet wurde. 


Erleichterte Fehlersuche 


Binsenweisheit: Je weniger Programmtext existiert, desto weniger Code muss nach Fehlern durchforstet werden. 


Mehr Einfluss 


Klassen erdffnen Ihnen mehr Einflussméglichkeiten, als Sie durch das Einftigen von Code in den Event-Handler eines 
Steuerelements haben. Tatsachlich konnen Klassen sogar die Steuerung von Meniis tibernehmen. Ferner k6nnen Sie 
Klassen anlegen, mit denen Sie eigene Steuerelemente definieren. Klassen haben dartiber hinaus den Vorzug, dass Sie 
eine Version der Klasse anlegen kdnnen, die den Zugriff auf den Quelltext unterbindet. Dadurch konnen Sie Klassen mit 
anderen REALbasic-Programmierern austauschen oder auch verkaufen. 


Insgesamt wird das Programmieren durch Verwenden von Klassen erheblich effizienter. 
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REALbasic besitzt viele eingebaute Klassen. PushButton, StaticText, EditField oder ListBox sind, um nur einige Beispiele 
zu nennen, Klassen von Steuerelementen. Solche Steuerelement-Klassen kann man als Vorlagen fiir die Objekte verste- 
hen, die Sie in dem GUI Ihrer Applikation verwenden. Sie sind eher abstrakt zu sehen, da sie selbst nie verwendet wer- 
den. Stattdessen werden Instanzen dieser Klassen erzeugt und verwendet. 


Wenn Sie beispielsweise ein EditField in ein Fenster ziehen, erzeugen Sie eine Instanz der EditField-Klasse. Diese Instanz 
enthalt alle Eigenschaften und Methoden der Vorlage. Dieses Prinzip gilt fiir alle weiteren Klassen. Sie passen die Instanz 
Ihren Bediirfnissen an, indem Sie deren Eigenschaften modifizieren. 


Definition von Unterklassen 


Manchmal werden Sie eine Klasse in einer Variante bendtigen, die gegentiber der Definition leicht modifiziert ist. Bei- 
spielsweise kGnnte es nétig sein, dass Sie ein EditField bendtigen, bei dem Ausschneiden (Cut) und Kopieren (Copy) im 
Menii deaktiviert sind, damit der Benutzer bestimmte Daten nicht ins Klemmbrett befordern kann (z.B. ein Passwort). 
Oder Sie brauchen eine ListBox, die als Grundeinstellung die Monate eines Jahres anzeigt. Solche Modifikationen der 
eingebauten Klassen konnen Sie mithilfe einer Unterklasse definieren, die Sie Ihrem Projekt hinzuftigen. 

Es gibt einen gravierenden Unterschied, ob Sie eine Klasse instanziieren, zum Beispiel, indem Sie ein Element in ein 
Fenster ziehen, oder eine Unterklasse ableiten und Ihrem Projekt hinzuftigen. Eine abgeleitete Klasse konnen Sie wie- 
derum instanziieren und einem Fenster hinzuftigen. Sie konnen die abgeleitete Klasse auch speichern und in anderen 
Projekten verwenden. 


Was ist eine Unterklasse? 


Eine Unterklasse ist eine Klasse mit einer tibergeordneten Oberklasse. Die Oberklasse ist die Basis der Unterklasse und 
wird auch ,,parent“ (Elternteil) genannt. Die Unterklasse wird von der Oberklasse abgeleitet. Unterklassen beherbergen 
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alle Eigenschaften, Methoden und Events ihrer Oberklasse, konnen sie aber verandern. Zundchst sind die Unterklassen 
mit den Oberklassen jedoch identisch, bis Sie anfangen, sie zu modifizieren. Danach bestehen die einzigen Unterschiede 
zur Oberklasse eben genau in den Punkten, in denen Sie Methoden, Eigenschaften oder Events verandert oder hinzuge- 
fiigt haben. 


Beispiele von Unterklassen 


Nehmen wir an, dass Sie ein EditField definieren, bei dem Ausschneiden (Cut) und Kopieren (Copy) im Menii deakti- 
viert werden (nennen wir es mal SecureEditField — sicheres Eingabefeld). Dazu legen Sie eine neue Klasse an und wah- 
len das EditField als seine Oberklasse (super class). Die neue Unterklasse ist in folgender Abbildung dargestellt: 


Abb. 224: Sicheres Eingabefeld basierend auf der EditField-Klasse 


eee Unterklassen (3) Eigenschaften 
[& Fensterl 
if Menii Name: SecureEditField 


Interfaces: 


(ga) SecureEditField 
Super: EditField 


40 


REALbasic aktiviert automatisch die Mentipunkte Ausschneiden und Kopieren, sobald Text im Eingabefeld selektiert 
wird. Weil der Fokus in EditFields gesetzt werden kann, hat jede Unterklasse des EditField-Objekts automatisch einen 
EnableMenultems-Event-Handler. Dies gestattet dem EditField, Einfluss auf die Meniis auszutiben, wenn der Fokus sich 
im EditField befindet. Um nun die Aktivierung der Mentipunkte Ausschneiden und Kopieren zu verhindern, mitissen Sie 
im Event-Handler EnableMenultems unseres neuen SecureEditFields die Eigenschaft Enabled fiir diese Mentipunkte 
auf False setzen. 


Abb. 225: Kopieren- und Ausschneiden-Menitipunkte im SecureEditField deaktivieren 


eee Code Editor (SecureEditField) 
> @ Sgenschaften 0 Sub EnableMenultems() 
v # Events Editcopy.enabled=False 
| Close Editcut.enabled=False| 
“S\ DropObject | End Sub 
EnableMenultems | 
GotFocus a 
“ KeyDown ’ 
= El fe! 


Um eine Instanz des SecureEditFields einzusetzen, draggen Sie es einfach aus dem Projektfenster in einen Fenstereditor. 
Auch wenn es aus dem Projektfenster und nicht aus der Steuerelementepalette auf den Fenstereditor gezogen wurde, 
sieht es wie jedes andere EditField aus. Es verhalt sich wie ein normales EditField, auSer dass die Mentipunkte Kopieren 
und Ausschneiden deaktiviert sind, wenn der Anwender Text selektiert hat. 
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Abb. 226: Eine Instanz eines SecureEditFields kann selektierten Text nicht kopieren. 


{ REALbasic Bearbeiten fala! 


[e is) Nam | 
SecureEditField h 
Hallo Einfiigen eV 


Loschen 


Da das SecureEditField im Projektfenster aufgeftihrt wird, konnen Sie davon an der jeder beliebigen Stelle Instanzen 
erzeugen und seinen Code an einer zentralen Stelle belassen und bearbeiten. 


Angenommen, Sie brauchen eine ListBox, die als Grundeinstellung alle Monate anzeigt und bei der der aktuelle Monat 
die voreingestellte Auswahl ist. Legen Sie zundchst eine neue Klasse an, die ListBox als Oberklasse hat. Im 
Open-Event-Handler Ihrer neuen Unterklasse verwenden Sie die Methode AddRow, um die Namen der Monate in die 
Box einzuftigen. Danach schreiben Sie die ben6tigten Programmzeilen, um den aktuellen Monat zu selektieren. 


Soll ein EditField angelegt werden, in das der Benutzer nur Zahlen eingeben kann, geht man so vor: Legen Sie eine 
Unterklasse der EditField-Oberklasse an und nennen Sie diese ,NumbersOnlyEditField“. Im Event ,,KeyDown* legen Sie 
den Programmteil ab, der Zahlen annimmt, aber alle anderen Zeichen ignoriert. Ist diese Unterklasse einmal definiert, 
konnen Sie auch an anderen Stellen des Projekts verwenden. Der Programmtext existiert aber nur genau einmal. 


Unterklassen sind normale Klassen. Sie heif’en nur Unterklassen, um sie von den vordefinierten Klassen zu unterschei- 
den und um zu betonen, dass sie die Eigenschaften, Events und Methoden der Eltern erben. Folgerichtig kann eine 
Unterklasse wiederum als Oberklasse ftir eine neue Unterklasse dienen. Wird ein Feld bendtigt, das nur Zahlen eines 
bestimmten Wertebereiches annimmt, legt man eine Unterklasse der gerade definierten Klasse , NumbersOnlyEditField“ 
an. Die neue Unterklasse hat zuniichst wieder die identische Definition von ,NumbersOnlyEditField". Im Event-Handler 
,lextChanged" definiert man nun aber zusatzlich noch, welcher Wertebereich akzeptiert werden soll. 


Man hitte genauso ein ,NumbersOnlyEditField“ kopieren k6nnen und den dort abgelegten Programmtext verdndern 
kénnen. Allerdings hatte man dadurch zusitzlichen Programmtext erzeugt und hitte sich spater bei Anderungen am 
»NumbersOnlyEditField“ daran erinnern miissen, dass es eine ahnliche Kopie des Programmtextes noch bei einem ande- 
ren Objekt gibt, bei dem man die gleichen Anderungen nochmals durchfiihren muss. 


Zugriff auf Eigenschaften und Methoden innerhalb einer 
Klasse 


Indem Sie ein Steuerelement, wie z.B. einen PushButton, um eigenen Code erweitern, fiigen Sie diesen Code genau 
genommen zu einer Instanz der PushButton-Klasse hinzu. Deshalb muss in Ihrem Code eine Referenz auf genau diese 
Instanz enthalten sein, da REALbasic sonst nicht feststellen konnte, auf welchen PushButton sich Ihr Code bezieht. 


Beim Hinzufiigen von Code zu einer Klasse oder Unterklasse ist es nicht notwendig, einen Bezug zu einer bestimmten 
Instanz herzustellen, denn der Code wird Teil der Klasse, in die er eingeftigt wird und nicht Teil der Instanz. Also referiert 
man innerhalb des Codes einer Klasse nicht auf Objekte dieser Klasse. Angenommen, Sie legen in einem Fenster einen 
PushButton namens PushButton1 an, der deaktiviert werden soll, nachdem der Benutzer ihn angeklickt hat. Der Code 
im Event-Handler des PushButtons wiirde dann so aussehen: 


PushButton1.Enabled=False 
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Hatte man statt dessen eine Unterklasse angelegt, deren Oberklasse PushButton ist, wiirde man nicht auf die Instanz 
referieren und der Code ware daher: 


Enabled=False 
Wird eine Unterklasse benutzt, bezieht sich der Code automatisch auf die Instanz, die gerade benutzt wird. 


Klassen anlegen 


Méchten Sie eine Klasse von einer bereits existierenden Klasse ableiten, so befolgen Sie die folgenden Schritte. 
1. Mit dem Projektfenster im Vordergrund wahlen Sie Ablage/Neue Klasse. 


Dem Projektfenster wird eine neue Klasse mit dem Namen Klasse1 hinzugeftigt. Wird die neue Klasse ausgewahlt, 
zeigt das Eigenschaftenfenster die Eigenschaften der neuen Klasse an. Standardmafsig wird die neue Klasse nicht von 
einer anderen Klasse abgeleitet. 


2. Soll die neue Klasse die Eigenschaften einer bestehenden Klasse tibernehmen, miissen Sie dazu im Eigenschaften- 
fenster die Super-Eigenschaft auf die Klasse setzen, von der die neue Klasse die Eigenschaften tibernehmen soll. 


3. Verwenden Sie das Eigenschaftenfenster, um der neuen Klasse einen Namen zu geben. 


Das ,,Gridlock*-Beispiel auf der CD verwendet ein herk6mmliches Steuerelement, um ein rechteckiges Gitter in ein 
Fenster zu zeichnen. In Abbildung 227 sehen Sie, dass dieses Steuerelement auf einem Canvas-Steuerelement basiert. 


Abb. 227: Die Gridlock-Klasse basiert auf dem Canvas-Steuerelement 


@ © © Gridlock Example © Eigenschaften 
:& Window1 
- Menu Name: Gridlock 
(ga) GridLock Interfaces: e 
Super: Canvas vw 


Wenn Sie die neue Klasse im Projektfenster ausgewahlt haben, k6nnen Sie sie doppelklicken, um den Code-Editor ftir 
die neue Klasse zu 6ffnen. 


Unterklassen aus vorhandenen Klassen ableiten 


Wenn Sie eine Unterklasse aus einer bereits im Projekt vorhandenen Klasse erzeugen wollen, gibt es daftir zwei Wege: 
Um eine Unterklasse einer bestehenden Klasse zu erzeugen, unternehmen Sie folgendes: 


1. Halten Sie die ctrl-Taste (Windows: rechte Maustaste) gedriickt und klicken Sie auf die Klasse, von der Sie eine Unter- 
klasse erzeugen méchten. 


2. Wahlen Sie Neue Unterklasse aus dem Kontextmenti. Dem Projekt wird eine neue Klasse hinzugefiigt. Im Eigen- 
schaftenfenster wird die bestehende Klasse als Eltern (Super)-Klasse der neuen Klasse eingesetzt. 


3. Verwenden Sie das Eigenschaftenfenster, um der Klasse einen neuen Namen zu geben. 
Um eine Unterklasse einer Steuerelement-Klasse zu erzeugen, unternehmen Sie folgendes: 


1. Draggen Sie das Steuerelement in das Projektfenster. Dadurch wird dem Projekt eine Klasse hinzugeftigt, die auf dem 
Steuerelement basiert. 


2. Verwenden Sie das Eigenschaftenfenster, um der Klasse einen neuen Namen zu geben. 
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Klassen sichern 


Da Klassen wiederverwendbar sind, werden Sie eine Bibliothek von Klassen anlegen wollen, die Sie ohne Miihe in 
andere Projekte importieren kénnen. Um eine Klasse zu sichern, mtissen Sie diese nur aus dem Projektfenster auf den 
Schreibtisch ziehen (Macintosh). Unter Windows wahlen Sie Datei/Exportieren und speichern die Klasse unter einem 
passenden Namen ab. Um die Klasse in einem anderen Projekt zu verwenden, draggen Sie sie vom Schreibtisch in das 
Projektfenster des neuen Projekts. 


Externe Projektelemente 


Wenn Sie eine Klasse in mehreren Projekten verwenden mochten, kénnen Sie diese Ihrem Projekt als externes Projekte- 
lement hinzufiigen. Ein externes Projektelement wird auf der Festplatte gespeichert. Jedes Projekt, das davon Gebrauch 
macht, enthiilt einen Verweis darauf. Wenn die Klasse in einem Projekt eine Anderung erfihrt, dann schligt sich diese 
Verinderung auch in allen anderen Projekten, die auf das externe Element verweisen, nieder. Veranderungen, die Sie an 
einem externen Projektelement vornehmen, werden mit dem Speichern des Projekts gespeichert. 


Um eine Klasse Ihres Projekts als externes Element zu speichern, machen Sie einen Ctrl-Klick auf die Klasse (Rechtsklick 
unter Windows) und wahlen aus dem Kontextmenii ,,Externes Element erzeugen“, worauf ein ,,.Datei exportieren‘-Dia- 
log erscheint. Nachdem Sie das Element gespeichert haben, wird es im Projektfenster kursiv dargestellt und das Icon 
erhilt einen kleinen Pfeil. 


Iyg) Gridlock 


Um einem anderen Projekt ein externes Element hinzuzufiigen, halten Sie die Befehls (88)- und Wahltaste (z) gedriickt 
(Windows: Ctrl+ Shift), wahrend Sie das Element vom Schreibtisch auf das Projektfenster ziehen. Im Projektfenster wird 
der Name des externen Elements kursiv angezeigt. 


Detaillierte Informationen zu diesem Thema finden Sie im Abschnitt Externe Projektelemente*“ auf Seite 83. 


Verandern von Klassen 


Ein grofer Vorteil des Klassenkonzeptes ist die Méglichkeit, bestehende Klassen zu modifizieren. Dies tun Sie durch 
Hinzufiigen von Konstanten, Eigenschaften und Anderungen an den Events oder den Methoden der Klasse. 


Giltigkeitsbereich von Konstanten, Eigenschaften und Methoden einer 
Klasse 


Wenn Sie einer Klasse eine Eigenschaft, Konstante oder Methode hinzuftigen, miissen Sie deren Giiltigkeitsbereich fest- 
legen. Der Giiltigkeitsbereich bestimmt, welche Teile des Projekts auf diese zugreifen konnen. 


Offentlich: Die Konstante, Eigenschaft oder Methode kann innerhalb des gesamten Projekts verwendet werden. Inner- 
halb des Objekts, in dem sie definiert wurde, erfolgt der Zugriff tiber den Namen, auferhalb iiber die Notation 
»Klassenname.Name“. 

Geschittzt: Geschiitzte Konstanten, Eigenschaften oder Methoden k6nnen nur in den Objekten der Klasse verwendet 
werden, in der sie erzeugt wurden. Andere Teile im Projekt k6nnen nicht darauf zugreifen. 

Privat: Eine private Konstante, Eigenschaft oder Methode ist der geschiitzten sehr ahnlich. Allerdings kann dieses Ele- 
ment nur in Code verwendet werden, der direkt zur Klassse gehdrt. Es steht nicht in von der Klasse abgeleiteten Klassen 
zur Verfiigung. 
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Hinzufiigen von Eigenschaften 


Sie konnen einer Klasse neue Eigenschaften zuordnen, um Werte zu speichern, die ihre Oberklasse nicht speichert. Bei- 
spielsweise kGnnte es sein, dass Sie einem EditField eine neue Eigenschaft geben mochten, damit es sich den letzten 
Wert merken kann, den der Benutzer eingegeben hat. Dies wiirde es Ihnen gestatten, auf Wunsch des Benutzers den 
letzten Wert des Feldes wieder herzustellen. 


So versehen Sie eine Klasse mit einer neuen Eigenschaft: 
1. Offnen Sie den Code Editor der Klasse mit einem Doppelklick auf ihr Icon im Projektfenster. 


2. Klicken Sie auf Bearbeiten/Neue Eigenschaft. Folgende Dialogbox erscheint: 


Abb. 228: Der Eigenschaften-Deklarations-Dialog 
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3. Geben Sie den Namen der Eigenschaft, ein ,,As“ und den Datentyp der Eigenschaft an. Zum Beispiel Name As String. 


Die Eigenschaft kann auch ein Array sein. Ein String-Array mit vier Elementen, das einen Namen, Nachnamen, die 


Anschrift und eine Telefonnummer aufnimmt, wiirde man so formulieren: 
aNamen(3) As String 


Sie miissen die Grd&e des Arrays angeben, kGnnen sie aber spater mit der ReEDim-Methode ver’ndern. 


4, Wahlen Sie einen Giiltigkeitsbereich fiir die Eigenschaft und aktivieren Sie, wenn gewtinscht, die Option Im 
Eigenschaftenfenster anzeigen. 


5. Klicken Sie auf OK. 


Die Eigenschaft wird nun im Code-Editor angezeigt. Ist es eine geschiitzte oder private Eigenschaft, wird im Icon ein 
Warndreieck angezeigt. 


6. Im Textfeld des Code-Editors konnen Sie Kommentare oder Notizen zu der Eigenschaft unterbringen. 


Hinzufiigen neuer Konstanten 


Sie konnen einer Klasse auch Konstanten hinzufiigen, denen Sie fixe Werte zuweisen. Eine Konstante verhiilt sich wie 
eine Eigenschaft, deren Wert man nicht verandern kann. Der Wert wird beim Erzeugen zugewiesen und ist dann unver- 
anderlich. 


Mit folgenden Schritten fiigen Sie einer Klasse eine neue Konstante hinzu: 
1. Offnen Sie den Code-Editor der Klasse. 
2. Rufen Sie den Mentipunkt Bearbeiten/Neue Konstante auf. 
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Daraufhin erscheint folgender Dialog: 


068 App Quellcode 
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Giultigkeitsbereich: “Geschiitzt (App und Unterklassen) wy 


Plattform Sprache Wert 


( Zufiigen ) Léschen © Abbrechen ) — our) 
Tn L 


3. Geben Sie den Namen, den Datentyp, den Giiltigkeitsbereich und den Wert der Konstanten ein. 


Wenn Sie einen mehrzeiligen String eingeben wollen, klicken Sie auf den kleinen Button, neben dem Eingabefeld. 
Dann konnen Sie den String in einem eigenen Dialog eingeben. 


4. Die Lokalisierungstabelle bietet Ihnen die Méglichkeit, der Konstanten abhangig von der beim Compilieren gewahl- 
ten Sprache und Zielplattform verschiedene Werte zuzuweisen. 


Weitere Informationen finden Sie im Abschnitt ,Lokalisieren einer Applikation mit Hilfe von Konstanten“ auf 
Seite 208. 


5. Klicken Sie auf OK, um die Konstante zu speichern. Die Konstante erscheint daraufhin mit ihrem Namen, Wert und 
einem Icon, das ihrem Typ entspricht, im Code-Editor. 


Hinzufigen neuer Methoden 


Sie konnen neue Methoden zu einer Klasse hinzufiigen, um diese Klasse mit zusatzlichen Funktionen zu versehen. Im 
GridLock-Beispiel gibt es beispielsweise eine Methode, die abhangig von der Anzahl an Zeilen und Spalten, die ihr tiber- 
geben wird, ein Gitter zeichnet. 


Detaillierte Informationen zum Anlegen von Methoden finden Sie im Abschnitt ,Methoden in einem Fenster anlegen“ 
auf Seite 209. Hier noch einmal das Vorgehen in Kurzform: 


. Fiihren Sie im Projektfenster einen Doppelklick auf die Klasse aus, um sie zu 6ffnen. 
. Wahlen Sie Bearbeiten/Neue Methode. Die Dialogbox zum Anlegen einer neuen Methode erscheint. 


. Geben Sie einen Namen fiir die Methode ein. 


1 
2 
3 
4. Soll die Methode Parameter erhalten, so geben Sie diese durch Komma getrennt ein. 
5. Falls es sich bei der Methode um eine Funktion handeln soll, legen Sie den Datentyp des Rtickgabewertes fest. 
6. Wahlen Sie einen Giiltigkeitsbereich fiir die Methode oder Funktion. 

7. Klicken Sie auf OK, um die Methode oder Funktion zu speichern. 


Der Code-Editor erscheint und zeigt die neu erstellte Methode/Funktion an. 


Neue Events definieren 


Events einer Klasse, zu denen Sie Programmcode definiert haben, sind einer Instanz dieser Klasse standardmafig nicht 
zuganglich. Stellen Sie sich folgendes vor: Sie haben eine Klasse, die auf ListBox basiert. Deren Event-Handler ,,Open“ 
erweitern Sie um eigenen Code. Instanzen dieser Klasse werden keinen eigenen Event-Handler ,Open* haben. Der Hin- 
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tergedanke dabei ist, dass die Klasse den Code ftir das Event schon beinhaltet und daher auch fiir die Bearbeitung 
zustandig ist. 


Es sind Falle denkbar, in denen Sie jeder Instanz einer Klasse eigenen Code fiir einen Event mitgeben méchten. Dies gilt 
zum Beispiel fiir Ausgangswerte. Im Event-Handler Open“ konnen Sie Ausgangswerte fiir die Klasse anlegen. Nehmen 
wir wieder das Beispiel der ListBox, die die Monatsnamen anzeigt und in der Sie den aktuellen Monat als Ausgangswert 
definieren wollen. Wird diese Klasse in einem Fenster verwendet, méchten Sie aber vielleicht diesen Ausgangswert 
andern und einen anderen Monat als Vorgabe wahlen. Die Instanz der ListBox wird aber keinen Event-Handler ,,Open“ 
haben und somit den Ausgangszustand erhalten, den die Klasse im Event ,Open* vorgibt. 


Dieses Problem kann man mit neuen Events ldsen. Legen Sie fiir die Klasse einen neuen ,,Open‘-Event an und rufen Sie 
Sie ihn vom Open-Event-Handler der Klasse auf. Neue Events sind nur den Instanzen der Klassen zuginglich. Somit ist 
der neu definierte Event fiir jede Instanz der Klasse vorhanden. Er wird immer dann aufgerufen, wenn das Fenster geoff- 
net wird, so wie ein normaler ,,Open‘-Event. 


Ein weiteres Beispiel: Angenommen Sie definieren eine Klasse, die ein Gitter zeichnet. Das Gitter zeigt dem Benutzer 
einzelne Zellen, die dieser durch Anklicken ein- und ausschalten kann. Sie m6chten nun einen neuen Event definieren, 
der immer dann eintritt, wenn der Benutzer eine Zelle anklickt. Nennen wir ihn ,,CellClicked“. Dieser Event soll die 
Information bekommen, in welche Zeile und Spalte geklickt wurde. Bei jeder Instanz der Klasse k6nnten Sie dann etwas 
auslosen, wenn der Benutzer in eine Zelle klickt. 


Wie macht man das? Erzeugen Sie fiir die Klasse zunachst einen neuen Event und nennen Sie ihn ,,BeiKlickAufZelle“. Da 
Sie als Parameter noch Zeile und Spalte haben mochten, definieren Sie diese Parameter fiir den Event, so wie es die 
Abbildung zeigt. 


Abb. 229: Ein neues Event anlegen 
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Nun stellt sich die Frage, wann der Event ausgeldst wird. Da der Benutzer mit der Maus klickt, um eine Zelle anzuwah- 
len, sollte der Mausklick den Event auslésen. Die Gitter-Klasse wiirde man von der Klasse Canvas ableiten. Dort sind die 
Events ,MouseDown“ und ,,MouseDrag* fiir Mausklicks zustandig. Von dort rufen Sie BeiKlickaufZelle auf, als wenn es 
sich um eine Methode handeln wiirde. Sie berechnen die Zeile und Spalte und iibergeben diese als Parameter an 
BeiKlickAufZelle. 


Klickt der Benutzer auf eine Zelle, wird der Event ,,MouseDown* der Klasse aktiviert. Dadurch wird auch ,,BeiKlickAuf- 
Zelle“ aufgerufen und Zeile und Spalte werden tibergeben. Der Event ,,BeiKlickAufZelle* wird so fiir jede Instanz bereit- 
gestellt. Die Klasse ruft eine Unterroutine der Instanz auf. Weil ,,BeiKlickAufZelle“ auch so angelegt werden kann, dass 
ein Wert zuriickgegeben wird, kann die Instanz der Klasse Daten an die Oberklasse zuriickliefern. Dies kann in unserem 
Beispiel dazu genutzt werden, um die Klicks zu filtern. Die Klasse wiirde den Klick immer dann weiter behandeln, wenn 
»BeiKlickAufZelle* den Wert False liefert, weil das die Standardriickgabe einer Funktion ist. Das wiirde jeder Instanz 
sofort gestatten festzustellen, welche Zellen angeklickt werden k6nnen und welche nicht. 


Ein Beispiel ftir diesen neuen Event finden Sie im ,,Gridlock“-Projekt auf der REALbasic CD. 
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Konstruktoren und Destruktoren 


Manchmal ist es niitzlich, wenn beim Erzeugen eines neuen Objekts automatisch eine Initialisierung des Objekts vorge- 
nommen wird. Ein Konstruktor leistet genau diese Arbeit. Ein Konstruktor wird immer genau dann ausgefiihrt, wenn 
eine neue Instanz der Klasse erzeugt wird. 

Angenommen, Sie brauchen eine ListBox, die als Grundeinstellung alle Monate anzeigt und bei der der aktuelle Monat 
die voreingestellte Auswahl ist. Legen Sie zunachst eine Unterklasse der ListBox mit dem Namen ,,Monate“ an. Wahlen 
Sie dazu Datei/Neue Klasse und tragen Sie im Eigenschaftenfenster den Namen der Klasse ein und setzen Ihre 
Super(Class)-Eigenschaft auf ListBox. 


Abb. 230: Eine Klasse mit ListBox als Super Class 
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Als nachstes klicken Sie im Projektfenster auf die ,Monate“-Klasse und offnen sie im Code-Editor. Wahlen Sie 
Bearbeiten/Neue Methode. Jetzt kGnnen Sie einfach eine Konstruktor- oder Destruktor-Methode erzeugen. Anstatt 
der Methode einen Namen zu geben, wahlen Sie dazu aus dem Popup rechts vom Namenseingabefeld entweder ,,Kon- 
struktor“ oder ,,Destruktor“. Dann wird der korrekte Name fiir den Konstruktor bzw. Destruktor in das Namensfeld ein- 
gefiigt. Da wir einen Konstruktor programmieren wollen, wahlen Sie ,,Konstruktor“. 


Abb. 231: Eine Konstruktor-Methode erzeugen 
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Als Methodenname wird der Name der Klasse eingefiigt. Der Konstruktor der ,,Monate“-Klasse heift also ,.Monate*. 


Er verwendet folgenden Code: 
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Abb. 232: Der ,,Monate”-Konstruktor 
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Beachten Sie, dass der Code nicht auf eine Instanz der ListBox verweist, da er der Unterklasse und nicht einer bestimm- 
ten Instanz, die sich von der ListBox-Klasse ableitet, hinzugeftigt wird. 

Fiigen Sie dann einem Fenster eine Instanz der Monate-Klasse hinzu, indem Sie sie aus dem Projektfenster in den Fens- 
tereditor draggen. In den Open-Event-Handler dieser Instanz schreiben Sie: 

me .Monate 

Der Konstruktor wird nun beim Starten der Anwendung aufgerufen. Als Ergebnis erhalten Sie eine ListBox, deren 
Inhalte automatisch eingetragen werden. Da im Konstruktor die ListIndex-Eigenschaft gesetzt ist, wird die aktuelle Zeile 
hervorgehoben. 


Abb. 233: Die ,,Monate”-ListBox in der fertigen Applikation 
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Sie konnen auch einen Destruktor anlegen. Ein Destruktor wird automatisch ausgeftihrt, wenn eine Instanz der Eltern- 
klasse geldscht bzw. nicht mehr benotigt wird (sich nicht mehr im Scope befindet). Zum Anlegen einer Destruk- 
tor-Methode wahlen Sie ,,Destruktor“ aus dem Popup-Menii neben dem Namensfeld der ,Neue Methode“-Dialogbox. 
Der Destruktor muss den gleichen Namen wie die Klasse mit vorangestellter Tilde (,,~“) tragen. 


Overloading 


REALbasic unterstiitzt auch das Overloading (Uberladen) von Methoden. Eine Sprache, die Overloading unterstiitzt, 
erlaubt Ihnen, zwei oder mehr Methoden zu definieren, die den gleichen Namen besitzen, jedoch eine unterschiedliche 
Anzahl an Parametern bzw. Parameter unterschiedlicher Datentypen verwenden. Wenn der Methodenname aufgerufen 
wird, ermittelt REALbasic aus den Parametern, welche Methode gemeint ist. Ein gutes Beispiel fiir Overloading ist der 
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eingebaute ,, + “-Operator. Wenn seine Argumente Zahlen sind, berechnet er deren Summe, wenn die Argumente Strings 
sind, hangt er diese aneinander. 


Doppelverwendung von selbstdefinierten Klassen 


In REALbasic konnen Sie Operatoren ,,tiberladen“, um damit arithmetische und Vergleichsoperationen in Ihren selbst 
programmierten Klassen durchzufiihren. Wenn Sie beispielsweise zwei Objekte, die Listen beinhalten, addieren wollen, 
konnen Sie eine Funktion schreiben, die den ,,+“-Operator fiir diese selbstdefinierte Klasse ,,tiberladt“. Zu diesem Zwe- 
cke verwendet REALbasic eine Reihe von SchliisselwGrtern. 


,Operator_Schltisselwort* steht fiir reservierte Worter, die es Ihnen erméglichen, die tiblichen arithmetischen und Ver- 
gleichsoperatoren in Ihre selbstdefinierten Klassen zu integrieren. 


Tabelle 34. Giiltige Operatoren und Schliisselworter ftir selbstdefinierte Klassen 


Operator Operator_Schliisselwort 


+ Operator_Add 
Operator_AddRight 


= Operator_Subtract 

Operator_SubtractRight 

Operator_Multiply 

Operator_MultiplyRight 

/ Operator_Divide 
Operator_DivideRight 

\ Operator_IntegerDivide 
Operator_IntegerDivideRight 


Mod Operator_Modulo 
Operator_ModuloRight 


=,<,><=,>= Operator_Compare 
(Negation) Operator_Negate 
(Konvertierung) | Operator_Convert 


wee) 


Um beispielsweise zwei Instanzen einer selbstdefinierten Klasse addieren zu k6nnen, definieren Sie fiir diese Klasse eine 
Funktion mit dem Namen ,,Operator_Add“. Diese Funktion legt fest, wie Objekte dieser Klasse addiert werden. Dann 
konnen Sie einfach den ,,+ “-Operator verwenden, um zwei Instanzen dieser Klasse zu addieren. 


Weitere Information zu diesem Thema erhalten Sie im Abschnitt ,Operator_Schliisselwort“ in der Sprachreferenz. 


Einer Methode einen Wert zuweisen 


Wenn Sie eine Methode aufrufen, konnen Sie Ihr wahlweise einen Wert zuweisen. Dazu verwenden Sie die gleiche Syn- 
tax, die Sie bei der Zuweisung eines Wertes zu einer Eigenschaft benutzen wiirden. Sie schreiben also: 
Objektname.Methodenname=Wert 


Dabei wird Wert dem Parameter zugewiesen, den die Methode als letzten erwartet. Der Wert muss dem Datentyp des 
Parameters entsprechen. Einer Methode, die mehrere Parameter erwartet, konnen Sie auf diese Weise nur den letzten 
Wert tibergeben. Alle anderen Werte miissen wie tiblich in Klammern hinter dem Methodennamen aufgezahlt werden. 
Wenn Sie diese Syntax verwenden wollen, miissen Sie beim Deklarieren der Methode das Schliisselwort ,,Assigns“ ver- 
wenden. 
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Beispiel: Sie haben eine Klasse ,,EigeneListbox“ definiert, die auf der ListBox-Klasse basiert. Fiir diese Klasse wollen Sie 
eine Methode programmieren, die abhangig von einem tibergebenen Integer-Wert eine neue Zeile mit dem passenden 
Monatsnamen in die Listbox einfiigt: 


Select case a 

case 1 

addrow "Januar" 
case 2 

addrow "Februar" 
case 3 

addrow "Marz" 
case 4 

addrow "April" 
case 5 

addrow "Mai" 

case 6 

addrow "Juni" 
case 7 

addrow "Juli" 
case 8 

addrow "August" 
case 9 

addrow "September" 
case 10 

addrow "Oktober" 
case 11 

addrow "November" 
case 12 

addrow "Dezember" 
end select 

End Sub 


Die Deklaration dieser Methode sieht folgendermafen aus: 


Abb. 234: Verwenden des ,,Assigns”-Schliisselwortes beim Deklarieren einer Methode 
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Wenn Sie das Assigns-Schltisselwort verwendet haben, konnen Sie den Integer-Wert mit dem Zuweisungsoperator an die 
Methode tibergeben: 

EigeneListbox.MonatHinzuftigen=2 

Nehmen wir einmal an, Sie schreiben fiir die ,,EigeneListBox“-Klasse eine weitere Methode namens ,Tabellenfeld 
Andern‘“, an die Sie die Parameter ,,Zeile* und Wert“ tibergeben kénnen. ,,Zeile“ bezeichnet das Tabellenfeld der ListBox, 
das Sie andern wollen, und Wert“ bezeichnet den neuen Wert. 


Sub TabellenfeldAndern(Zeile as Integer, Assigns Wert as String) 
Cell (Zeile,0)=Wert 
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End Sub 
Falls Sie den dritten Eintrag der ListBox auf ,New York“ dndern moéchten, wtirde der herkommliche Aufruf so aussehen: 
EigeneListBox.Tabel lenfeldAndern(2,”New York”) 


Bei der Verwendung von Assigns kGnnen Sie die Zeile als Parameter und den neuen Wert mittels Zuweisungsoperator 
angeben: 


EigeneListBox.TabellenfeldAndern(2)="New York” 


Klassen-Arrays 


Genau wie mit Objekten ist es mdglich, ein Array aus Instanzen einer Klasse zu erzeugen. Beispielsweise knnen Sie ein 
Array aus Steuerelementen der Benutzeroberflache Ihres Programms erzeugen, um die Verwaltung der Benutzeroberfla- 
che zu vereinfachen. Dazu geben Sie allen Steuerelementen den gleichen Namen und unterscheiden sie anhand ihrer 
Index-Eigenschaft. Arrays aus Steuerelementen wurden im Abschnitt ,Gemeinsamer Code fiir ein Array aus Steuerele- 
menten* auf Seite 219 vorgestellt. 


Es ist mOglich, ein Array aus Instanzen einer Klasse zu erzeugen, die kein Steuerelement ist. Dabei kénnen Sie die 
Objekthierarchie oder Klassen-Interfaces ausnutzen. Wenn myClass1 von mySuperClass1 oder von einem von myClass1 
implementierten Klassen-Interface abgeleitet wurde, kann ein Array von myClass1 iiberall verwendet werden, wo ein 
Array von mySuperClass1 erwartet wird. Das Array behalt seine urspriinglichen Elementtypen bei. Jedes Einfiigen, 
Andern und jede Zuweisung an Array-Elemente wird tiberpriift, um sicher zu stellen, dass der neue Wert den richtigen 
Elementtyp hat. Wenn der Typ nicht passt, wird eine TypeMismatchException ausgeldst. Diese konnen Sie mit einer 
Catch-Anweisung in einem Try-Block oder in einem Exception-Block abfangen. 


Casting 


Eine leistungsfahige MOglichkeit, wiederverwendbaren Code zu schreiben, besteht darin, die Objekthierarchie mittels 
Casting auszunutzen. Am besten lasst sich dies mit einem Beispiel illustrieren: 


Da von Ihnen erzeugte Objekte Unterklassen der Basisklassen der REALbasic-Sprache sind, kénnen Sie mit dem 
IsA-Operator testen, ob ein Objekt Mitglied einer bestimmten Unterklasse ist. Ist dies der Fall, konnen Sie das Objekt auf 
diesen Typ ,,casten“ und Operationen mit dem Objekt ausftihren. 


Das Beispiel verwendet eine For-Schleife, die alle Steuerelemente eines Fensters durchlauft und jedes darauf testet, ob 
es ein EditField ist. Ist dies der Fall, wird das Steuerelement auf EditField gecastet und die Werte seiner Text- und Data- 
Field-Eigenschaften ermittelt. Der Text wird dann einem Feld eines Datensatzes zugewiesen, das so heifst wie die Data- 
Field-Eigenschaft des EditFields. 


Dim r as DatabaseRecord 
Dim fieldname, fieldContents as String 


For i = 1 to Self.ControlCount //Anzahl Steuerelemente im Fenster 
If Self.control(i) IsA EditField then 
fieldname = EditField(control(i)).DataField //auf EditField casten 
//Die Text-Eigenschaft, die dem Inhalt dieses Feldes zugewiesen ist 
fieldContents = EditField(control(i)).text 
r.column(fieldname) = fieldContents 


end if 
next 


Dieser Code ist universell, da er auf keine spezifischen Fenster, EditFields oder Datenbanken verweist. Daher konnen Sie 
diese Routine in beliebigen Projekten ftir Datenbank-Eingabemasken verwenden. 
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Klassen kontrollieren Meniipunkte 


Sobald eine Klasse den Fokus erhilt, hat sie die Kontrolle tiber die Meniileiste. Dies erleichtert das Kapseln von Code in 
einem Steuerelement. Unterklassen von Klassen, die den Fokus erhalten k6nnen, verftigen tiber einen EnableMenu- 
Items-Event-Handler und k6nnen fiir jedes Menii des Projekts einen eigenen Event-Handler haben. 


Der EnableMenultems-Event-Handler einer Klasse wird immer dann ausgeldst, wenn der Anwender in die Meniileiste 
klickt oder einen Tastatur-Shortcut fiir einen Mentipunkt tippt. Dadurch hat die Klasse die Gelegenheit, Mentipunkte 
ein- oder auszuschalten. Als nachstes wird der EnableMenultems-Event-Handler des Fensters, gefolgt von dem der Appli- 
cation-Klasse ausgelost. Wird dann ein Mentipunkt ausgewahlt, priift REALbasic, ob die Klasse, bei der gerade der Fokus 
liegt, einen Menu-Handler fiir den gewahlten Mentipunkt hat. Ist dieser vorhanden, so wird er ausgefiihrt, gefolgt vom 
Menu-Handler des Fensters und von dem der Application-Klasse (jeweils unter der Annahme, dass diese tiber einen 
Menu-Handler ftir den ausgewahlten Meniipunkt verfiigen). 


Sie erinnern sich vielleicht an das SecureEditField, das im Abschnitt ,,Beispiele von Unterklassen“ auf Seite 306 vorge- 
stellt wurde. Dies ist ein Beispiel ftir eine Klasse, die Mentipunkte kontrolliert. Dort wurde schon erlautert, wie Menii- 
punkte ausgeschaltet werden, die REALbasic sonst automatisch aktiviert. 


Verwendung von Klassen im eigenen Projekt 


Bevor Sie in Ihren Projekten Klassen verwenden k6nnen, sollten Sie sich mit den zugrundeliegenden Konzepten und 
Begriffen vertraut machen. Dabei sind drei Begriffe von besonderer Bedeutung: Klasse, Instanz und Referenz. 


Die Klasse 


Eine Klasse ist eine Vorlage ftir eine Sammlung aus Events, Methoden und Eigenschaften, aus der Sie Instanzen und 
Unterklassen erzeugen konnen. 


Die Instanz 


Jede Instanz ist ein Speicherbereich, in dem eine Kopie der Eigenschaften einer Klasse gespeichert wird. Methoden wer- 
den nicht mit jeder Instanz in den Speicher kopiert, sondern erst dann aus der Klasse in den Speicher geladen, wenn sie 
aufgerufen werden. 


Die Referenz 


Die Referenz ist ein Wert, der in einer Eigenschaft oder einer lokalen Variablen abgelegt wird und auf die Instanz einer 
Klasse im Speicher verweist. Sie verwenden diese Eigenschaft oder Variable, um auf die Instanz der Klasse zuzugreifen. 
Hier ein Beispiel: 
Dim person as Programmer 

person=New Programmer 

person.name="Jason" 

person’ ist eine lokale Variable, die eine Referenz auf eine Instanz der Klasse Programmer“ speichert. Dazu wird sie als 
»Programmer* definiert. Mit dem Kommando ,,New“ wird eine neue Instanz der Klasse ,,Programmer* im Speicher ange- 
legt. Sie miissen sich das so vorstellen, dass jeder ,New*-Befehl eine neue Kopie der Klasse nach der durch die Klasse 
definierten Vorlage im Speicher anlegt. 


Die Zuweisung beim Kommando ,,New“ bewirkt nun, dass eine Referenz auf die neue Instanz in der lokalen Variable 
person“ abgelegt wird. REALbasic kann nun tiber den Wert in person“ den Speicherbereich wiederfinden, in dem sich 
die Instanz befindet. In der nachsten Zeile des Beispiels wird die Referenz dazu benutzt, in der Eigenschaft ,Name“ den 
Namen ,,Jason“ abzulegen. 
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Auf Steuerelementen basierende Unterklassen 


Die einfachste Moglichkeit einem Projekt eine Klasse, die auf einem Steuerelement basiert, hinzuzuftigen, besteht darin, 
das Steuerelement von der Steuerelementepalette auf das Projektfenster zu ziehen. Daraufhin wird dem Projekt eine 
neue Klasse mit dem Namen ,,SteuerelementnameX“ hinzugeftigt und das Eigenschaftenfenster zeigt an, dass die Klasse 
eine Unterklasse der Steuerelement-Klasse ist. Das ,,X“ wird dabei durch eine fortlaufende Zahl ersetzt. Verwenden Sie 
das Eigenschaftenfenster, um der Klasse einen neuen Namen zu geben. 


Sie eine Unterklasse eines Steuerelements auch dadurch anlegen, dass Sie Datei/Neue Klasse wahlen. Damit legen Sie 
eine neutrale Klasse an. Im Eigenschaftenfenster konnen Sie die Super(Class)-Eigenschaft auf die Klasse eines Steuerele- 
ments dndern. 


Da Sie die Klasse von einem Steuerelement abgeleitet haben, konnen Sie der Klasse neue Eigenschaften und Methoden 
hinzuftigen, um ihr individuelles Steuerelement zu erzeugen und anschlieSend eine Instanz ihres individuellen Steuere- 
lements einem Fenster hinzuftigen. 


Um eine Instanz einer Klasse zu erzeugen, der ein Steuerelement zugrunde liegt, ziehen Sie einfach das Element vom 
Projektfenster in das Fenster, in dem Sie die neue Instanz verwenden wollen — gerade so, als ob Sie eine Instanz eines 
eingebauten Steuerelements erzeugen wollten, indem Sie sein Icon aus der Steuerelementepalette ,,herausdraggen“. 


Andere Instanzen/Klassen 


Klassen miissen nicht auf Steuerelementen aufbauen, sondern k6nnen auch von Klassen abgeleitet werden, die nicht 
Bestandteil der Control-Klasse sind. Ein Beispiel daftir ware die Thread-Klasse. Es ist mdglich, eine Unterklasse der 
Thread-Klasse zu erzeugen und ftir diese neue Eigenschaften zu definieren, in denen bestimmte Informationen abgelegt 
werden k6nnen. 


Es ist auch méglich, eine ganz neue Klasse anzulegen, die gar keine Oberklasse besitzt. Beispielsweise konnten Sie eine 
Klasse ,,Personen“ anlegen. Eigenschaften der Klasse waren dann Name, Alter und Gréfe. Von dieser Klasse konnten Sie 
wiederum eine Unterklasse ,,ComputerAnwender“ ableiten. Diese konnte weitere Eigenschaften definieren, die Sie fiir 
diese Gruppe von Personen speichern wollen. 

Um eine Instanz auf eine solche Klasse zu erzeugen, mtissen Sie zunachst etwas haben, um diese zu speichern. Sie k6n- 
nen diese in einer Eigenschaft oder in einer lokalen Variablen ablegen. Diese miissen vom Typ der Klasse oder einer 
ihrer Oberklassen sein. BenGtigen Sie beispielsweise eine Instanz der Date-Klasse, um ein Geburtsdatum zu speichern, 
erzeugen Sie eine Variable vom Typ Date. Dort legen Sie dann eine Referenz auf die erzeugte Instanz ab. 

Mit der Dim-Anweisung erzeugen Sie die Variable. Mit dem New-Operator erzeugen Sie eine neue Instanz und speichern 
in der Variablen eine Referenz auf diese. 


Dim Geburtstag as Date 
Geburtstag=New Date 


In diesem Beispiel ist die lokale Variable ,,Geburtstag* vom Typ Date. Dann wird mit dem New-Operator eine neue 
Instanz der Date-Klasse erzeugt und eine Referenz in der lokalen Variable abgelegt. 

Sie konnen die Schreibweise straffen, indem Sie den New-Operator mit der Dim-Anweisung verbinden. Damit erzeugen 
Sie in einem Schritt die Variable und die Instanz und weisen der Variablen die Referenz auf die Instanz zu. 

Dim Geburtstag As New Date 


Zugriff auf Methoden und Eigenschaften einer Klasse 


Nachdem Sie eine Instanz einer Klasse und eine Referenz auf diese erzeugt haben, konnen Sie genau wie bei Objekten 
auf die Methoden und Eigenschaften der Klasse zugreifen. Im folgenden Beispiel hat die lokale Variable Geburtstag 
Zugriff auf die Eigenschaften der Date-Klasse. Sie konnen also mit Hilfe der lokalen Variable die Eigenschaften andern. 
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Dim Geburtstag as New Date 

Geburtstag. Year=1967 

Geburtstag.Month=3 

Geburtstag. Day=21 

Dieses Beispiel basiert auf einer in REALbasic eingebauten Klasse. Wenn Sie eine abgeleitete Klasse verwenden, haben 
Sie natiirlich Zugriff auf deren Eigenschaften und zusatzlich auf die Eigenschaften der Klasse, von der Sie Ihre Klasse 
abgeleitet haben. 


Wann werden Instanzen von Klassen aus dem Speicher entfernt? 


REALbasic verwaltet den Speicher selbst und verwendet dazu eine Technik namens Reference-Counting (Referenzzih- 
lung). REALbasic fiihrt einen Zahler fiir jede Instanz, die sie erzeugen und zahlt die Referenzen auf das Objekt. Jede Refe- 
renz erhoht den Zahler. Das Entfernen einer Referenz auf das Objekt verkleinert den Zahler. Sie entfernen eine Referenz, 
indem Sie sie z.B. auf Nil setzen oder das Fenster schliefen, in der sich die Instanz befand. Wenn der Reference-Counter 
den Wert Null annimmt, wird das Objekt sofort aus dem Speicher entfernt. Instanzen von Klassen werden also automa- 
tisch aus dem Speicher entfernt, sobald sie nicht mehr gebraucht werden. 


Angenommen, Sie haben in einem Fenster eine Instanz einer ListBox angelegt. Wenn das Fenster ge6ffnet wird, wird im 
Speicher automatisch eine Instanz der ListBox erzeugt. Beim SchliefSen des Fensters wird diese wiederum automatisch 
aus dem Speicher entfernt. Wird eine Referenz auf eine Klasse in einer lokalen Variablen abgelegt, so verschwindet die 
damit erzeugte Instanz wieder aus dem Speicher, sobald das Event oder die Methode, die die Instanz erzeugt hatte, 
beendet wird. Ist eine Referenz auf eine Instanz in einer Eigenschaft einer Klasse gespeichert, wird der Speicher daftir 
freigegeben, sobald das Objekt, zu dem diese Eigenschaft gehort, aus dem Speicher entfernt wird. 


Die Application-Klasse 


Aus der Application-Klasse k6nnen Sie eine Klasse ableiten, die Ihre Anwendung reprasentiert. Deshalb kann es in einem 
Projekt nur eine Klasse geben, die auf der Application-Klasse basiert. Beim Anlegen eines neuen ,,Desktop-Applica- 
tion“-Projekts wird diesem automatisch eine Unterklasse der Application-Klasse, die App-Klasse, hinzugefiigt. 

Das Eigenschaftenfenster der App-Klasse zeigt Application“ als ,,Super“-Klasse. AufSerdem gehort auch die Stan- 
dard-Meniileiste (Meniileiste1) der App-Klasse. 


Abb. 235: Die Standard-Applikation-Klasse 


@ © © Namenios oO Eigenschaften 
[® Fensterl 
iGy Menileiste1 
(ed) App 


Name: App 
Interfaces: 
MenuBar: Menileiste1 


440 


Super: Application 


Spezielle Event-Handler der Application-Klasse 
Die Application-Klasse bietet spezielle Event-Handler. Diese sind: 


© Open: Wird ausgeftihrt, wenn das Programm mit Debug/Programm starten (8-R oder Strg-R) oder als 
Stand-Alone-Programm gestartet wird. 

e Close: Wird ausgefiihrt, wenn das Programm beendet wird. 

© NewDocument: Wird ausgefiihrt, wenn die Applikation als Stand-Alone-Programm gestartet wird. Wird nicht ausge- 
fiihrt, wenn die Applikation durch Doppelklick auf ein von ihr erzeugtes Dokument gestartet wird. 
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© OpenDocument: Wird ausgefiihrt, wenn die Applikation als selbstandiges Programm durch Doppelklick auf eine dem 
Programm zugeordnete Dokumentendatei gestartet wird. 

e EnableMenultems: Wird ausgeftihrt, wenn der Benutzer in die Meniileiste klickt, und zwar bevor das Menii gezeich- 
net wird. Vorher werden die EnableMenultems-Event-Handler aller Klassen mit Instanzen im obersten Fenster und 
der EnableMenultems-Event-Handler des obersten Fensters selbst ausgefiihrt. Daher sollte man den EnableMenu- 
Items-Event-Handler der Application-Klasse zur Aktivierung der Mentipunkte verwenden, die nicht davon abhangen, 
ob ein bestimmtes Fenster ge6ffnet ist oder nicht. 

Soll ein Mentipunkt immer aktiviert sein, verwenden Sie ftir diesen die AutoEnable-Eigenschaft und nicht den 
Event-Handler. 

© HandleAppleEvent: Wird ausgefiihrt, wenn die Anwendung einen AppleEvent empfingt. 

© Activate: Tritt auf, wenn die Anwendung geoffnet oder nach vorne geholt wird. 

© Deactivate: Die Anwendung wird deaktiviert. Tritt auf, wenn eine andere Anwendung oder der Schreibtisch in den 
Vordergrund riickt oder wenn die Anwendung beendet wird. 

© Unhandled Exception: Wird ausgefiihrt, wenn ein Laufzeitfehler auftritt, der nicht von einem ExceptionBlock abge- 
fangen wird. Dieser Event bietet Ihnen eine ,,letzte Chance“, Laufzeitfehler abzufangen, bevor diese Ihre Anwendung 
,unerwartet“ beenden. 


Eigenschaften der Application-Klasse sind global 


Offentliche Eigenschaften der Application-Klasse sind global verfiigbar. Sie konnen also von jedem Teil des Projekts ver- 
wendet werden. Stellen Sie dazu den Giiltigkeitsbereich der Eigenschaft auf ,,Offentlich*. Die abgebildete Eigenschaft 
der App-Klasse kann von jedem Teil des Projekts verwendet werden: 


°e8 App Quellcode 
| Deklaration: |FehlerCode Asinteger| Cd 
' Giiltigkeitsbereich: _ Offentlich (Uberall) zs) 
| Im Eigenschaftenfenster anzeigen 
a 


(Abbrechen ) EXD 


] +) oO 


Verwenden Sie die App-Funktion, um auferhalb der App-Klasse auf die Eigenschaften der App-Klasse zuzugreifen. Um 
z.B. von einem anderen Teil des Projekts auf die Fehlercode-Eigenschaft zuzugreifen, verwenden Sie folgende Syntax: 
App.Fehlercode 


Ist der Gtiltigkeitsbereich ,,Geschiitzt“, kann die Eigenschaft nur innerhalb der App-Klasse verwendet werden. 
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Methoden der Application-Klasse sind global 


Auf 6ffentliche Methoden der Application-Klasse kann tiberall im Projekt zugegriffen werden. Dazu muss als Giiltigkeits- 
bereich ,,Offentlich* gewdhlt werden. Wenn Sie der App-Klasse eine Methode namens ,,Foo" hinzufiigen, 


068 App Quelicode 

q 

Method @ 

q 

| Parameter: 

a 

g 

a 

Riickgabetyp: 8 
(jo) Gultigkeitsbereich: { Offentlich (Uberall) [E3) 
~= Loa 


(Abbrechen ) OD 


k6nnen Sie diese folgendermafen aufrufen: 
App. Foo 
Ist der Giiltigkeitsbereich ,,Geschiitzt* oder ,,Privat’, so ist die Methode nur innerhalb der App-Klasse erreichbar. 


Anlegen selbstdefinierter Steuerelemente mit Klassen 


Eine der wichtigsten Anwendungen der Klassen ist die Definition eigener Steuerelemente. Die meisten Steuerelemente 
sind in REALbasic zwar schon vorhanden, aber es wird dennoch Falle geben, in denen Sie selbst solche Elemente definie- 
ren méchten. Angenommen, Sie mdchten ein Gitter mit Zellen erzeugen. Der Benutzer soll auf Zellen klicken k6nnen, 
um diese zu selektieren. Die Abbildung zeigt ein Beispiel, wie das aussehen konnte. 


Abb. 236: Selbstdefiniertes Grid-Steuerelement 


Selbstdefinierte Steuerelemente sind Unterklassen und werden von der Canvas-Klasse abgeleitet. Die Canvas-Klasse 
stellt eine Zeichenflache zur Verfiigung, auf der das Steuerelement dargestellt werden kann und empfangt alle nétigen 
Events, tiber die Anwender und Steuerelement interagieren konnen. 


Im Beispiel des Grid-Steuerelementes in Abbildung 236 ist das Objekt eine Instanz der GridLock-Klasse, die von der Can- 
vas-Klasse abgeleitet wurde. Das Beispielprogramm Gridlock“ finden Sie auf der REALbasic CD. Die GridLock-Klasse 
iibernimmt alle Eigenschaften und Events des Canvas-Steuerelements und besitzt eigene Methoden, Eigenschaften und 
Events zum Zeichnen und zur Interaktion. Das Gitter wird im Paint-Event-Handler des GridLock-Steuerelements 
gezeichnet. 


In Eigenschaften der ,,Gridlock“-Klasse wird die Zeilen- und Spaltenzahl gespeichert. Diese konnen fiir jede Instanz ver- 
wendet werden. Weitere Eigenschaften speichern die Farbe fiir selektierte und nicht selektierte Zellen. Klickt der Benut- 
zer auf eine Zelle, wird der Event-Handler ,,MouseDown“ der Gridlock-Klasse aktiv. Der Code dieses Event-Handlers 
stellt fest, welche Zelle angeklickt wurde und ob diese selektiert oder deselektiert werden muss. Zur GridLock-Klasse 
gehort ein Event ,,CellClicked“, das aufgerufen wird, wenn der Benutzer auf eine Zelle klickt. Damit kann eine Instanz 
der Gridlock-Klasse auf einen Klick reagieren. ,,CellClicked“ erhalt als Parameter die Zeilen- und Spaltennummer der 
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angeklickten Zelle und ist als Funktion definiert. Wenn eine Instanz der Gridlock-Klasse im CellClicked-Event-Handler 
den Wert True zuriickliefert, geht die Gridlock-Klasse davon aus, dass der Programmierer den Klick herausfiltern wollte 
und verhilt sich so, als ob der Benutzer die Zelle nicht angeklickt hatte. 


Zeichnen eines Steuerelements 


Der ,,Paint-Event-Handler der Canvas-Klasse (oder einer von ihr abgeleiteten Klasse) wird immer dann aufgerufen, 
wenn das Steuerelement neu gezeichnet werden muss. Dies passiert zum Beispiel, wenn ein Fenster das Steuerelement 
verdeckt hatte und nun geschlossen wird. Verandert sich das Aussehen eines Elements wahrend der Benutzung nie, 
kann das Zeichnen des Elements immer komplett vom Paint-Event ausgefiihrt werden. Miissen Anderungen eingeplant 
werden, ist anders vorzugehen. Das Gridlock beispielsweise andert sich immer, wenn der Benutzer eine Zelle anklickt. 
AufSerdem hat es eine Funktion (DefineGrid), die es erlaubt, permanent die Anzahl der Zeilen und Spalten zu ver’indern. 
Solche Aktionen erfordern natiirlich ein Neuzeichnen des Elements. 


Der Code ftir das Neuzeichnen des Elements findet sich normalerweise in einer eigenen Methode. Im Gridlock-Beispiel 
heifst diese ,DrawGrid“. Sie bekommt die Graphics-Eigenschaft der Canvas-Klasse geliefert, die sie verwendet, um das 
Gitter neu zu zeichnen. Dadurch, dass der Code dafiir in einer eigenen Methode liegt, kann diese bequem sowohl vom 
Event-Handler ,,Paint“ als auch von der DefineGrid-Methode aufgerufen werden. Dem Paint-Event-Handler wird eine 
Referenz auf die Graphics-Eigenschaft tibergeben, so dass diese an die DrawGrid-Methode weitergegeben werden kann, 
wenn sie vom Paint-Event-Handler aufgerufen wird. Die Methode ,,DefineGrid“ ruft die Methode ,,DrawGrid“ auf, da bei 
einer Anderung der GréRe logischerweise auch das Gitter neu gezeichnet werden muss. Die Methode ,DrawGrid* erhilt 
die Graphics-Eigenschaft in folgender Syntax: 


DrawGrid Me.Graphics 


»Me* ist dabei eine Referenz auf die Instanz der Gridlock-Klasse. Obwohl der Code in diesem Fall innerhalb der Grid- 
lock-Klasse aufgerufen wird, gestattet die Benutzung der Referenz ,,Me“ den Zugriff auf die Eigenschaften der aktuell im 
Gebrauch befindlichen Instanz. 


Virtuelle Methoden 


Virtuelle Methoden erlauben es, dass eine Unterklasse eine eigene Version einer Methode verwendet. Normalerweise 
erben Unterklassen die Methoden ihrer Elternklasse. 


Das Konzept virtueller Methoden wird auch als ,,Polymorphismus“ bezeichnet. 

Wenn eine Unterklasse eine Methode besitzt, die denselben Namen wie eine Methode der Elternklasse hat, wird immer 
die Methode der Unterklasse ausgefiihrt, es sei denn, man verwendet die Syntax: 

elternklassenname.methodenname 

So wird eine virtuelle Methode erzeugt: 

1. Erzeugen Sie eine Klasse. 

2. Ftigen Sie der Klasse eine Methode hinzu. 

3. Erzeugen Sie eine Unterklasse dieser Klasse. 

4. Fiigen Sie der Unterklasse eine Methode mit dem Namen der Klasse aus Schritt 2 hinzu. 


Wenn die Unterklasse die Methode aufruft, wird sie ihre eigene Version, nicht die der Elternklasse verwenden. 


324 Wiederverwendbare Objekte durch Klassen 


Klasseninterface 


Ein Klasseninterface ist ein Konstrukt, mit dem Sie verschiedene Klassen zusammenfassen k6nnen, die eine gleichartige 
Funktion erfiillen. Verstehen Sie ein Klasseninterface als eine Art Spezifikation, die verschiedene Methoden definiert. Ein 
Klasseninterface enthilt allerdings nur die Definition, nicht den Code selbst. 


Eine Methode in einem Klasseninterface ist tatsdchlich nur ein Platzhalter fiir Methoden, die letztendlich in einer beliebi- 
gen Klasse implementiert sind. In dem Fall spricht man davon, dass die Klasse das Klasseninterface implementiert. Dabei 
miissen alle im Klasseninterface spezifizierten Methoden implementiert werden. Die Deklarationen miissen tiberein- 
stimmen, aber der Inhalt der Methoden kann unterschiedlich sein. Dies wird manchmal auch Polymorphismus genannt. 
Beispielsweise wird eine Methode, die den Text eines StaticText-Objekts andert, anders formuliert sein, als eine, die den 
Text in einem Canvas-Objekt mit Hilfe des Graphics-Objekts andert. 


Der gesamte Prozess lasst sich in drei Phasen aufteilen: 


© Erzeugen eines Klasseninterfaces 

© Erzeugen der Klassen, die das Klasseninterface implementieren 

© Hinzufiigen der Klassen zum Projekt und Verwenden der Klassen. Ublicherweise bedeutet dies, dass Ihr Programm 
priift, ob ein Klasseninterface implementiert ist und es dann verwendet. 

Um ein Klasseninterface zu erzeugen, fiihren Sie folgende Schritte aus: 

1. Wahlen Sie den Meniipunkt Ablage/Neues Klasseninterface. 
Ein neues Klasseninterface wird dem Projekt hinzugeftigt und das Icon erscheint leicht durchsichtig im Projektfen- 
ster, was signalisieren soll, dass dort kein Code implementiert ist. Das Eigenschaftenfenster zeigt, dass die einzige 
Eigenschaft eines Klasseninterfaces sein Name ist. Es hat auch keine tibergeordnete Klasse, da es auSerhalb der 
Objekt-Hierarchie liegt. 


@ © @ Namenios @) Eigenschaften 
[& Fensterl 
fy Menileiste1 


Name: Interfacel 


(ea) App 


2. Jetzt konnen Sie den Namen des Klasseninterfaces im Eigenschaftenfenster dndern. 

3. Klicken Sie im Projektfenster doppelt auf das Klasseninterface, um dessen Code-Editor zu 6ffnen. 
Der Browser des Code-Editors enthalt nur die Eintrage ,Methoden“ und ,,Notizen“. Sie konnen keine Konstanten 
oder Eigenschaften ftir ein Klasseninterface erzeugen. 

4, Rufen Sie Bearbeiten/Neue Methode auf, um eine Methode fiir das Klasseninterface zu deklarieren. 


088 Interfacel Quellcode 


c] 
3 Methode: iG) 


Parameter: 


Riickgabetyp: is) 


(Abtrechen) OD 
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5. 


Bestimmen Sie den Namen, die Parameter und den Riickgabetyp, falls ein Rtickgabewert bentigt wird. 

Anders gesagt: Deklarieren Sie die Methode, wie Sie es bereits gelernt haben. Nur einen Giiltigkeitsbereich konnen 
Sie nicht angeben, da das Klasseninterface selbst keinen Code enthilt. Es dient ja lediglich dazu, die Methoden zu 
spezifizieren, die anderswo implementiert werden. 

Wenn Sie die Deklaration mit Klick auf OK abgeschlossen haben, werden Sie feststellen, dass der Code-Editor es 
nicht gestattet, Code fiir diese Methode einzugeben. Dies ist so beabsichtigt und kein Fehler. 

Wiederholen Sie die Schritte 4 und 5, bis alle benotigten Methoden des Klasseninterfaces deklariert sind. 


Nachdem Sie das Klasseninterface erzeugt haben, miissen Sie es einer oder mehreren abgeleiteten Klassen zuweisen. 
Um das Beispiel nicht zu einfach zu halten, gehen wir von zwei oder mehr Klassen aus. Nun miissen Sie in jeder der 
zugewiesenen Klassen die deklarierten Methoden implementieren. 


Um ein Klasseninterface zu implementieren gehen Sie folgendermassen vor: 


1 


bo 


3 
4 


5 


6 
7 


. Bei aktivem Projektfenster wahlen Sie den Meniipunkt Ablage/Neue Klasse. 


Eine neue Klasse wird dem Projekt hinzugeftigt. Das Eigenschaftenfenster der Klasse enthalt die Eigenschaft ,,Inter- 
faces“, der Sie ein Klasseninterface zuweisen kGnnen. Sie konnen auch mehrere Klasseninterfaces angeben. 


@ © @ Namenios (a) Eigenschaften 
(@ Fensterl 
[Gj Menileiste1 
(aa) App 
£3 FontinterfaceManager 


(Pf) EigenesEditField 


Name: EigenesEditField 
Interfaces: FontinterfaceManager e 
Super: EditField v 


. Geben Sie den Namen des Klasseninterfaces an, das von der Klasse implementiert wird. 
Eine Klasse kann mehrere Klasseninterfaces implementieren. Trennen Sie mehrere Interfaces mit Kommata. 
. Doppelklicken Sie die Klasse und 6ffnen Sie so ihren Code-Editor. 
. Wahlen Sie Bearbeiten/Neue Methode. 
. Geben Sie die Deklaration an, die Sie fiir die Methode auch im Klasseninterface verwendet haben. 
Diesmal akzeptiert der Code-Editor die Eingabe von Code. 
. Schreiben Sie die Implementierung der Methode fiir diese Klasse. 


. Wiederholen Sie die Schritte 4 bis 6 fiir die Methoden jedes weiteren Klasseninterfaces, das diese Klasse implemen- 
tiert. 


. Wiederholen Sie den gesamten Vorgang fiir jede Klasse, die ein Klasseninterface implementiert. 


Beispielprojekt eines Klasseninterfaces 


Das folgende Beispiel verdeutlicht das zugrundeliegende Konzept. Die Applikation besitzt zwei Klassen, die von den 
Klassen StaticText und EditField abgeleitet sind. Das Klasseninterface besteht aus einer Methode, die den Zeichensatz 
aktualisiert. Wenn der Benutzer einen Zeichensatz aus dem Menii auswahlt, wird eine Nachricht an alle Steuerelemente 
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eschickt, die das Klasseninterface implementieren. 
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Das Klasseninterface ,,FontInterfaceManager“ besitzt eine Methode: 


°e8 FontinterfaceManager Quellcode 
Methode: | ZeichensatzAktualisieren| iB) 


Parameter: NeuerZeichensatz As String 


Riickgabetyp: ie) 


Bie) LD 


] | fel oO HA 


Jede Klasse, die das Klasseninterface implementiert, muss eine Methode besitzen, die ZeichensatzAktualisieren heift 
und einen String als Parameter akzeptiert. 

Die zwei Klassen MeinStaticText und MeinEditField implementieren diese Methode, wie Sie den Eigenschaftenfenstern 
dieser Klassen entnehmen kénnen: 


@ © @ KlasseninterfaceB... is) Eigenschaften fa) Eigenschaften 
(& Fenster1 
[Gj Menileiste1 Name: MelnEditFleld Name: MeinStaticText 
(@ App Interfaces:~ FontinterfaceManager te) Interfaces: FontinterfaceManager e 
£2) FontinterfaceManager Super: EditField NA Super: StaticText v 


ed 
(gg) MeinStaticText 


| 1 
Die Implementierung der Methode ZeichensatzAktualisieren ist zufallig in beiden Klassen identisch, dies muss aber 
nicht so sein! 
Sub ZeichensatzAktualisieren(s As String) 

Self .TextFont=s 
End Sub 
Mit Objekten dieser Klasse in einem Fenster kann nun generischer Code geschrieben werden, der priift, ob ein Steuere- 
lement das Klasseninterface implementiert. 


Nehmen wir an, es sind mehrere dieser Objekte in einem Fenster. Der folgende Code befindet sich im Change-Event 
eines PopupMenu-Objekts und andert den Zeichensatz der Objekte, wenn der Benutzer einen neuen Zeichensatz aus- 
wahlt. Mit Hilfe des IsA-Operators wird getestet, ob das Steuerelement das Klasseninterface implementiert. Trifft dies zu, 
wird dessen ZeichensatzAktualisieren-Methode aufgerufen. Uber den Ausdruck Me. Text erreicht man den aktuell ausge- 
wahlten Eintrag des PopupMenus. 
Dim i as Integer 
For i=0 to Self.ControlCount // Anzahl der Steuerelemente im Fenster 
If Self.Control(i) IsA FontInterfaceManager then 
FontInterfaceManager(Self.Control(i)).ZeichensatzAktualisieren(Me. Text) 
End if 
Next 
Jede selbst definierte Klasse kann also unabhangig von ihrer Superklasse ein Klasseninterface implementieren. Klassen- 
interfaces erlauben es, Klassen miteinander in Beziehung zu setzen, die in der Objekthierarchie in keinerlei Beziehung 
stehen, und Methoden fiir diese Klassen an einer zentralen Stelle des Projekts zu verwalten. 
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Interface-Vererbung 


Interface-Vererbung dient zur komfortablen Lésung eines haufig auftretenden Problems. Wenn Ihre Anwendung meh- 
rere verschiedene Steuerelemente verwendet, die dieselbe Aufgabe auf unterschiedliche Art und Weise ausfiihren sollen 
(abhangig vom konkreten Typ jedes Steuerelements), k6nnen Sie dank Interface-Vererbung den Interface-spezifischen 
Teil [hres Programmcodes auf elegante Art und Weise schreiben und ausftihren. 


Abbildung 237 zeigt eine Applikation, die Interface-Vererbung verwendet. Die Applikation soll einen vom Benutzer ein- 
gegebenen String in den drei Steuerelementen iiber der Separator-Linie finden: Das EditField, die ListBox und das 
PopupMenu basieren jeweils auf benutzerdefinierten Klassen. Obwohl die Aufgabe ftir die drei Steuerelemente identisch 
ist (eine Suchfunktion), kann sie nicht mit exakt dem gleichen Code realisiert werden, da die drei Objekte ihre Daten 
unterschiedlich speichern und manipulieren. Deshalb verwendet jede benutzerdefinierte Klasse ihre eigene Implemen- 
tierung der zum Suchen notwendigen Methoden. 

Die ListBox, das EditField und das PopupMenu wurden von benutzerdefinierten Klassen abgeleitet, die alle ein benutzer- 
definiertes Interface, das FindInListInterface, verwenden. Alle drei Steuerelemente verfiigen tiber eine Suchen-Funktion, 
die dieselben Parameter empfangt, aber unterschiedlich implementiert ist. Der Programmcode fiir den Find-Button 
kann die verschiedenen Suchen-Funktionen mit derselben Syntax aufrufen. 


Abb. 237: Eine Beispielanwendung fiir Interface-Vererbung 


e0ce Untitled ® © © inheritance 
. a [®@ Window1 
—. . i) Menu 
Fred ing] ——— 
Wilma (ga) myListBox 
4 (ga) myPopup 


(ga) myEditField 


Der Anwender gibt den zu suchenden String im EditField FindValue links neben dem Find-Button ein. Wenn der Anwen- 
der den Find-Button anklickt, wird folgender Code ausgefiihrt: 

FindIt FindValue.text, listBoxl 

FindIt FindValue.text, popupMenul 

FindIt FindValue.text, editFieldl 

Die Funktion FindIt wird fiir alle drei Steuerelemente aufgerufen. Tatsachlich wird in jeder Programmzeile eine andere 
Version von FindIt ausgefiihrt, und zwar die zum jeweiligen Steuerelement passende. Der zweite Parameter von FindIt 
ist der Name des jeweiligen Steuerelements. Jedes Steuerelement hat Methoden von der benutzerdefinierten Klasse 
geerbt, auf der es basiert. 


Das EditField, das PopupMenu und die ListBox sind Instanzen von benutzerdefinierten Klassen. Diese Klassen verfiigen 
iiber die zwei Methoden Find und SelectRow, die die Suchfunktion ftir das jeweilige Objekt implementieren (siehe 
Tabelle 35). 
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Tabelle 35. Finden-Funktionen und SelectRow-Methoden fiir verschiedene Steuerelemente 


Steuerelement Find Funktion 


SelectRow Methode 


EditField Function Find (FindValue as string) as Integer Sub SelectRow (Row as Integer) 
dim rows, foundPos, foundCRpos as integer — dim counter, startPos, endPos as integer 
rows=-1 do until counter=row 
foundPos =instr(text,findValue + chr(13)) startPos=instr(startPos+ 1, text, chr(13)) 
do until foundCRpos > =foundPos if startPos <> 0 then 
foundCRpos=instr(foundCRpos + 1, text, counter=counter+ 1 
chr(13)) end if 
rows=rows + 1 loop 
loop endPos=instr(startPos + 1,text,chr(13)) 
return rows selStart=startPos 
selLength=endPos-startPos 
ListBox Function Find (FindValue as string) as Integer Sub SelectRow (Row as Integer) 
dim i as integer listindex=row 
for i=0 to listcount-1 
if list(i) =findValue then 
return i 
end if 
next 
PopupMenu Function Find (FindValue as string) as Integer Sub SelectRow (Row as Integer) 


dim i as integer listindex=row 


for i=0 to listcount-1 
if list(i) =findValue then 
return i 
end if 
next 


Die FindIt-Methode selbst verwendet das FindInListInterface: 


Sub FindIt (findValue as String, source as SucheInListelInterface) 

dim row as integer 

source.selectRow source. find(findValue) 
End Sub 
Das Klasseninterface FindInListInterface deklariert lediglich die Methoden Find und SelectRow und deren Parameter. 
Wenn die FindIt-Methode aufgerufen wird, ruft sie immer die Versionen von Find und SelectRow auf, die zu dem Steuer- 
element gehoren, das als zweiter Parameter an FindIt tibergeben wurde. 


Benutzerdefinierte Objektverknupfungen 


Mittels Objektverkntipfungen konnen Funktionen realisiert werden, ohne dass daftir Code geschrieben werden muss. In 
REALbasic sind bereits viele Aktionen eingebaut, die von verkntipften Objekten ausgeftihrt werden kénnen (siehe auch 
,Object Binding — Objektverkniipfung* auf Seite 135). 


Uber die vorhandenen Aktionen hinaus kénnen Sie eigene Verkniipfungen programmieren, indem Sie benutzerdefi- 
nierte Klassen verwenden. Auch die selbstdefinierten Verkniipfungen erscheinen automatisch im Dialog ,Neue Verkniip- 
fung“, wenn Sie mit der Maus bei gedriickter Shift- und Befehlstaste (Windows: Shift- und Strg-Taste) eine Linie 
zwischen zwei geeigneten Objekten ziehen. 

Eine selbstdefinierte Verkniipfung kénnen Sie mittels Drag & Drop in jedes Projekt itibernehmen. Sie wird genauso 
transparent funktionieren wie die in REALbasic eingebauten Verkntipfungen. Es folgen zwei Beispiele ftir benutzerdefi- 
nierte Objektverkntipfungen. 


Benutzerdefinierte Objektverkniipfungen 329 


Die Verknupfung ,,L6sche alle Zeilen” 


Dieses erste Beispiel erzeugt eine benutzerdefinierte Verkniipfung zwischen PushButtons und ListBoxen. Mit ihr kann 
der Anwender einen PushButton anlegen, der alle Zeilen einer ListBox ldscht. Als erstes erzeugen Sie eine benutzerdefi- 
nierte Klasse, die das Interface fiir die Verkntipfung enthillt. 


1. Fiigen Sie Ihrem Projekt eine neue Klasse hinzu. 
2. Nennen Sie die neue Klasse ,,DeleteAllRowsBind“. 


Daes sich bei dieser Klasse um eine Verkntipfung handeln soll, muss sie das bindingInterface unterstiitzen. Da auSer- 
dem im Action-Event des PushButtons eine Aktion ausgefiihrt werden soll, die der ListBox bei Klick auf den PushBut- 
ton mitteilt, dass sie alle Eintrage loschen soll, muss das ActionNotificationReceiver-Interface unterstiitzt werden. 


3. Um das bindingInterface und das ActionNotificationReceiver-Interface zu unterstiitzen, tragen Sie 
,»bindingInterface,ActionNotificationReceiver* in die Interfaces-Eigenschaft der Klasse ein. 


Jetzt knnen Sie die bind-Methode implementieren. 
4. Fiigen Sie Ihrer Klasse die neue Methode ,,Bind“ mit den Parametern ,Source as Object, Target as Object“ hinzu. 


Da der Code, der bei Klick auf den PushButton ausgeftihrt wird, wissen muss, welcher PushButton mit welcher List- 
Box verkniipft ist, mtissen diese als Eigenschaften in der Klasse gespeichert werden. 


5. Erganzen Sie die Klasse um folgende neue Eigenschaften: BindSource as Pushbutton und BindTarget as ListBox. 


6. Schreiben Sie folgenden Code in die Bind-Methode: 
#tpragma bindingSpecification pushbutton, listbox,"Delete all rows in %2 when %1 is pushed" 
BindSource=pushbutton(source) 
bindTarget=1istbox(target) 
BindSource.addActionNotificationReceiver self 
Die #pragma-Anweisung legt fest, was in der Objektverkniipfung-Dialogbox erscheinen soll, wenn der Anwender die 
beiden Objekte verkniipft, indem er die Maus bei gedriickter Befehls-, Shift- und Maustaste vom Quell- zum Zielob- 
jekt (also vom PushButton zur ListBox) zieht. Die #pragma-Anweisung bestimmt die Quell- und die Zielklasse und 
enthalt den Text, der im Objektverkntipfung-Dialog erscheint. %1 wird durch den Namen des Quell-Steuerelements, 
%2 durch den Namen des Ziel-Steuerelements ersetzt. 


Wenn die Verkniipfung zutrifft (also der PushButton gedrtickt wird), werden die verkniipften Steuerelemente an die 
Bind-Methode iibergeben, und zwar als generische Objekte. Um die Objekte in den BindSource- und BindTar- 
get-Eigenschaften zu speichern, die Sie in Schritt 5 angelegt haben, miissen sie die Objekte mittels Typkonvertierung 
wieder zu einem PushButton und einer ListBox machen. Die Programmzeilen 2 und 3 der Bind-Methode erledigen 
genau dies. 
Die letzte Programmzeile stellt die Verbindung zwischen der DeleteAllRowsBind-Klasse und dem Action-Event des 
PushButtons her, indem die Methode addActionNotificationReceiver der PushButton-Klasse aufgerufen wird. Als 
Parameter wird self“ tibergeben, wodurch die DeleteAllRowsBind-Klasse selbst reprasentiert wird. 
Jetzt fehlt noch der Programmcode, der die Zeilen der ListBox loscht, wenn der Anwender den PushButton anklickt: 
7. Ftigen Sie dazu die neue Methode ,,PerformAction* zu Ihrer Klasse hinzu. 
8. Der Programmcode dieser PerformAction-Methode sieht so aus: 
bindTarget.DeleteAl1Rows 
Um die neue Objektverkntipfung auszuprobieren, platzieren Sie eine ListBox und einen PushButton auf einem Fen- 
ster und fiillen die ListBox mit einigen Zeilen. Verkniipfen Sie die beiden Steuerelemente, indem Sie bei gedriickter 
Shift-, Befehls- und Maustaste die Maus vom PushButton zur ListBox ziehen. Wenn der Dialog ,,Neue Verkniipfung“ 
erscheint, wird auch die selbsterzeugte Verkniipfung aufgelistet (siehe Abbildung 238). 
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Abb. 238: Die selbstdefinierte Verkniipfung in der Liste der Verkniipfungen 


Neue Verkniipfung 


Enable PushButton2 when ListBox] has a selection 
Delete all rows in ListBox1 when PushButton2 is pushed 


(Abbruch ) OK 


9. Wahlen Sie den Eintrag Delete all rows from listbox1 when pushbutton1 is pushed und testen Sie die neue Ver- 
kntipfung in der Laufzeitumgebung. 


Die Verknupfung ,,L6sche die selektierte Zeile” 


Um eine Verkniipfung zu erzeugen, die daftir sorgen soll, dass die selektierte Zeile einer ListBox geloscht wird, sobald 
ein PushButton gedriickt wird, legen Sie in Ihrem Projekt eine neue Klasse an und wiederholen Sie alle oben beschriebe- 
nen Schritte. 


Da die neue Version der Verkniipfung nur aktiv werden soll, wenn eine Zeile selektiert ist, miissen einige zusatzliche 
Interfaces unterstiitzt werden, damit man mitbekommt, ob der Anwender eine Zeile auswahlt. 


1. Legen Sie in Ihrem Projekt die Klasse DeleteSelectedRowBind an. 


2. Erganzen Sie listSelectionNotificationReceiver bei der Interfaces-Eigenschaft der Klasse. Das Eigenschaftenfenster 
sollte dann aussehen wie in Abbildung 239. 


Abb. 239: Das Eigenschaftenfenster der Klasse DeleteSelectedRowBind 


is} Eigenschaften 


Name: DeleteLSelectedRowBind 
Interfaces: Bindinginterface,jistSelectionNotificationReceiver,ActionNotificationReceiver ©) 
Super: <none> v 


3. Versehen Sie die Klasse mit der neuen Methode ,,Bind“. Geben Sie der Methode die Parameter ,,Source as Object, Tar- 
get as Object“. 

4. Geben Sie den folgenden Programmcode ein: 
#tpragma bindingSpecification pushbutton, listbox,"Delete the selected row in %2 when %1 is pushed" 


BindSource=pushbutton(source) 
bindTarget=1istbox(target) 


BindTarget.addListSelectionNotificationReceiver self 

BindSource.addActionNotificationReceiver self 

BindSource.enabled=(bindTarget.listindex >= 0) 

Die erste neue Programmzeile sorgt daftir, dass die DeleteSelectedRowBind-Klasse tiber jede Veranderung der Selek- 
tion in der ListBox informiert wird. Die letzte Zeile aktiviert das Quellobjekt (den PushButton), wenn beim Offnen 
des Fensters eine Zeile des Zielobjektes (der ListBox) selektiert ist und deaktiviert das Quellobjekt, wenn im Zielob- 
jekt keine Selektion vorliegt. 

Nun muss der Programmcode hinzugeftigt werden, der den PushButton aktiviert bzw. deaktiviert, wenn der Anwen- 


der im gedffneten Fenster Eintrige der ListBox selektiert bzw. deselektiert. Dazu muss die Klasse um die Methoden 
erweitert werden, die Teil des ListSelectionNotificationReceiver-Interfaces sind. 
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5. Erweitern Sie die Klasse um die Methoden ,,SelectionChanged“ und ,,SelectionChanging“. Beide haben keine Parame- 
ter. Schreiben Sie folgenden Programmcode in die SelectionChanged-Methode: 
bindSource.enabled=(bindTarget.listindex >= 0) 


Immer, wenn sich die Selektion in der ListBox verandert, wird die Verkniipfung aktiv und die SelectionChan- 
ged-Methode aufgerufen. 

Die SelectionChanging-Methode hat keinen Programmcode. 

Jetzt fehlt nur noch der Programmcode, der daftir sorgt, dass die ausgewahlte Zeile geléscht wird, wenn der Anwen- 
der auf den PushButton klickt. 


6. Fiigen Sie die PerformAction-Methode hinzu und geben Sie folgende Programmzeile ein: 
bindTarget.removeRow bindTarget.listindex 


Schlieflich k6nnen Sie einen weiteren Knopf auf dem Fenster ablegen und ihn mit der ListBox verkntipfen. 
7. Wahlen Sie die neue Verkniipfung aus und testen Sie sie in der Laufzeitumgebung. 


Exportieren und Importieren von Klassen 


Klassen k6nnen exportiert und importiert werden. Wird eine Klasse exportiert, erscheint sie auf dem Desktop mit einem 
Wiirfelsymbol wie in Abbildung 240. Um eine Klasse zu importieren, ziehen Sie einfach das Symbol auf Ihr Projektfens- 
ter. Dabei wird eine Kopie der Klasse in Ihrem Projekt angelegt. Das Projekt ist also nicht mit der Datei auf dem Desktop 
verkniipft. Sie konnen diese wegwerfen, wenn Sie sie nicht fiir ein anderes Projekt bendtigen. 


Abb. 240: Eine exportierte Klassen-Datei 


w 
ws 

GridLock 
Ist eine importierte Klasse von einer anderen Klasse abhingig, so muss diese andere Klasse ebenfalls in dem Projekt vor- 
handen sein. Dies ist natiirlich nicht von Bedeutung, wenn die zugrunde liegende Klasse zu den in REALbasic eingebau- 
ten Klassen geh6rt (wie z.B. EditField etc.). 
Exportierte Klassen k6nnen verschliisselt werden, so dass man sie zwar importieren, nicht aber den Quelltext ansehen 
oder verandern kann. Wenn die Klasse verschliisselt ist, wird das Icon der Klasse im Projektfenster mit einem kleinen 
Schliissel-Symbol dargestellt. 


Abb. 241: Eine verschliisselte Klasse 
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Weitere Informationen entnehmen Sie dem Abschnitt ,Verschliisseln des Quelltextes* auf Seite 332. 


Importieren externer Projektelemente 


Wenn Sie eine Klasse in mehr als einem Projekt verwenden mochten, dann kénnen Sie diese Ihrem Projekt als externes 
Projektelement hinzufiigen. Ein externes Projektelement wird auf der Festplatte gespeichert und jedes Projekt, das 
davon Gebrauch macht, fiihrt einen Verweis darauf. Wenn die Klasse in einem Projekt eine Anderung erfahrt, dann 
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schlagt sich diese Veranderung auch in allen anderen Projekten, die auf das externe Element verweisen, nieder. Verande- 
rungen, die Sie an einem externen Projektelement vornehmen, werden mit dem Speichern des Projekts gespeichert. 


Um Ihrem Projekt ein externes Element hinzuzufiigen, halten Sie die Befehls (88)- und Wahltaste gedriickt (Windows: 
Strg+Shift), wahrend Sie das Element vom Schreibtisch auf das Projektfenster ziehen. Im Projektfenster wird der Name 
des externen Elements in Kursivschrift angezeigt. 


Detaillierte Informationen zu diesem Thema finden Sie im Abschnitt Externe Projektelemente“ auf Seite 83. 


Ob die Klasse geschiitzt ist, konnen Sie nach dem Import feststellen, indem Sie einen Doppelklick auf die Klasse im Pro- 
jektfenster ausftihren. Sollte die Klasse geschiitzt sein, weist eine Dialogbox Sie darauf hin. 


Es gibt zwei Arten des Exports. Sie konnen die Klasse einfach aus dem Projektfenster auf den Desktop ziehen. Dabei ent- 
steht eine Datei mit dem Namen der Klasse wie in Abbildung 240. Wenn man den Ordner, in den exportiert werden soll, 
auf dem Desktop nicht sehen kann, dann kann der Export auch tiber Ablage/Klasse exportieren erfolgen. 


Verschliisseln des Quelltextes 


Wenn Sie anderen REALbasic-Benutzern eine selbstentwickelte Klasse, aber nicht deren Quelltext zur Verftigung stellen 
wollen, k6nnen Sie vor dem Export den Quelltext der Klasse verschliisseln. Das erzeugt beim Export eine Klasse, die 
man importieren und benutzen, jedoch nicht anschauen oder bearbeiten kann. Das ist vor allem dann interessant, wenn 
Sie ausgefeilte Klassen entwickeln, die Sie als Add-Ons verkaufen wollen. 


Zum Verschliisseln der Klasse klicken Sie im Projektfenster auf dieselbe und rufen Bearbeiten/Verschlisseln auf. Alter- 
nativ k6nnen Sie auch einen ctrl-Klick (Windows: Rechtsklick) auf den Namen der Klasse machen und im Kontextmenii 
erschliisseln* aufrufen. 


Abb. 242: Das Kontextmenii im Projektfenster 
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Es erscheint folgende Dialogbox: 


Abb. 243: Der Verschliisseln-Dialog 


MeinEditField verschlissein 


Pawort: 


Bestatigen: 


™ V3 Verschliisselung oder héher verw. 


(Abbrechen ) ( Verschlussele 


Geben Sie ein Passwort fiir die Verschliisselung ein und bestitigen Sie dieses. Selektieren Sie V3 Verschliisselung oder 
hoher verw. nur, wenn die Klasse mit der Version 3 oder héher von REALbasic verwendet wird. Deselektieren Sie die 
Option nur, wenn Sie die Klasse mit REALbasic 3.0 oder kleiner verwenden wollen. 


Wichtig: Vergessen Sie ihr Passwort nicht! 
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Das Symbol einer verschliisselten Klasse im Projektfenster wird mit einem Schliissel versehen. Wenn ein Anwender ver- 
sucht, eine verschliisselte Klasse im Fenstereditor zu ffnen, erscheint folgende Warnbox: 


Abb. 244: Der Dialog ,,Objekt verschliisselt” 


! Dieses Objekt wurde vom Autor 
verschlisselt - es kann nicht 
gedffnet werden 
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Um die Klasse oder ihren Code zu bearbeiten, miissen Sie sie mit dem Passwort entschltisseln. Selektieren Sie dazu die 
Klasse im Projektfenster und rufen Sie den Mentipunkt Bearbeiten/Entschliisseln auf. Es erscheint der Entschltis- 
seln-Dialog. 


Abb. 245: Der Entschliisseln-Dialog 


SecureEditField entsperren 
Pawort: 


(Abbruch )  Entsperrer 


Geben Sie das Passwort ein und klicken Sie auf Entschliisseln. Nach kurzer Zeit verschwindet der Schliissel aus dem 
Symbol der Klasse, um anzuzeigen, dass die Entschliisselung erfolgreich war. Wenn Sie das Passwort nicht kennen oder 
vergessen haben, gibt es keine Moglichkeit, die Klasse zu entschliisseln. 


Wenn Sie eine verschliisselte Klasse weitergeben oder verkaufen wollen, miissen Sie eine Liste ihrer Methoden und 
Eigenschaften zur Verfiigung stellen, da es ja ohne Passwort nicht méglich ist, den Quelltext einzusehen. 


Loschen einer Klasse 


Bevor Sie eine Klasse ldschen, sollten Sie ganz sicher sein, dass diese weder von anderen Klassen benutzt wird, noch als 
Oberklasse fiir andere Klassen dient. 


So entfernen Sie eine Klasse aus einem Projekt: 
1. Wahlen Sie die Klasse im Projektfenster aus. 


2. Driicken Sie entweder die Backspace-Taste, rufen Sie den Meniipunkt Bearbeiten/Léschen auf oder fiihren Sie 
einen ctrl-Klick (Windows: Rechtsklick) auf die Klasse aus und rufen im Kontextmenti Léschen auf. 


Diese Aktion ldsst sich mit Bearbeiten/Undo (38-Z bzw. Strg-Z) riickgangig machen. 
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xitei1o Datenbankprogrammierung mit 
REALbasic 


Mit REALbasic k6nnen Sie Datenbankanwendungen programmieren, die auf verschiedene Datenbank-Engines aufsetzen 
k6nnen, z.B. auch auf die mitgelieferte Datenbank-Engine von REAL Software. 

Die Datenbank von REAL Software, genannt REALdatabase, in der Standard- und Professional-Version von REALbasic ent- 
halten und wird vollstandig unterstiitzt. 


Die Verbindung mit Datenbank-Servern wird nur von REALbasic Professional unterstiitzt. 


Inhalt 


Die Datenbankarchitektur von REALbasic 

Die Datenbankwerkzeuge in REALbasic 

Anlegen und Modifizieren von Datenbanken im Projektfenster 
Das DataControl Steuerelement 

Verwenden von Objektverkniipfungen 

Programmieren eines Datenbank-Frontends 


Die Datenbankarchitektur von REALbasic 


Sie konnen mit REALbasic ein Frontend zu Ihrer Datenbank programmieren. Dieses Frontend arbeitet mit einem Daten- 
bank-Backend (einer Datenbank-Engine) zusammen, das fiir die eigentlichen Datenbankoperationen, wie das Speichern 
der Daten, zustandig ist. Die Rolle des Datenbank-Backends kann von einer separaten Applikation oder von der in REAL- 
basic integrierten Datenbank-Engine tibernommen werden. 


Das Frontend dient dabei als Benutzerschnittstelle und Hilfsmittel, mit dem Abfragen an die Quelle gestellt und Informa- 
tionen angezeigt und gedruckt werden. Der Endanwender verwendet das Frontend, um Datensatze zu betrachten, ein- 
zugeben, zu modifizieren, zu suchen, zu sortieren und auszudrucken. 


Sie k6nnen ein zusatzliches Datenbankprogramm, wie z.B. 4D Server von 4th Dimension oder Oracle einsetzen, um die 
Daten zu verwalten. Die Datenbankapplikation, die ftir die tatsachliche Datenverwaltung zustandig ist, wird als ,Daten- 
quelle“ bezeichnet. 


Der grofse Vorteil dieser Architektur besteht darin, dass ein mit REALbasic programmiertes Datenbank-Frontend mit 
allen unterstiitzten Datenquellen zusammenarbeiten kann. Sie k6nnen zur Entwicklung einer Datenbankanwendung die 
interne REAL-Datenbank-Engine verwenden und spater das System an hohere Anforderungen (z.B. Multi-User-Betrieb) 
anpassen, indem Sie die Datenquelle wechseln. 


Ein REALbasic Datenbank-Frontend kann auch mit mehreren verschiedenen Datenquellen gleichzeitig zusammenarbei- 
ten. Beispielsweise k6nnten lokale Daten von 4D Server geliefert werden, wahrend tiber eine Remote-Verbindung Daten 
eines SQL-Servers oder einer ODBC-Datenbank bezogen werden. 


Zur Unterstiitzung der verschiedenen Datenquellen gibt es spezielle Datenbank-Plugins von REAL Software und von 
Drittanbietern. Die Datenbank-Plugins miissen sich im Plugins-Verzeichnis innerhalb des REALbasic-Verzeichnisses 
befinden, damit Sie sie in Ihrem Projekt verwenden kénnen. Eine Ausnahme bildet die REALdatabase, die integraler 
Bestandteil von REALbasic ist. 
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Es ist mOglich, zusatzliche Datenquellen zu unterstiitzen, indem entsprechende Plugins fiir die jeweiligen Backends ent- 
wickelt werden. Das Plugin-SDK von REAL Software liefert die notwendigen Informationen, um eigene Datenbank-Plug- 
ins zu schreiben. 


Strukturierte Abfragesprache 


Ein REALbasic Datenbank-Frontend verwendet zur Kommunikation mit seiner Datenquelle die Strukturierte Abfra- 
gesprache SQL (Structured Query Language). Das Datenbank-Plugin, das Sie zum Zugriff auf Ihre Datenquelle verwen- 
den, empfangt eine SQL-Anweisung von REALbasic, tibersetzt diese — falls notwendig — in eine fiir Ihre Datenquelle 
verstandliche Form und sendet diese an die Datenquelle. 

Die mitgelieferte REALdatabase verwendet die in diesem Abschnitt beschriebene Untermenge des SQL-Standards. I 


Fall der REALdatabase wird das Plugin als integraler Bestandteil von REALbasic mitgeliefert, muss also nicht als zusatz 
che Datei im Plugins-Verzeichnis installiert werden. 


nS 


Fast alle von REALbasic unterstiitzten Datenbankserver verfiigen iiber native SQL-Backends (die einzige Ausnahme ist 
4DServer). Wenn Sie mit einem nativen SQL-Backend arbeiten, tibergibt das REALbasic-Plugin Ihren SQL-Befehl unmodi- 
fiziert an die Datenquelle. Das heifst, dass Sie alle ftir diese Datenquelle giiltigen SQL-Befehle in Ihrem REALbasic-Fron- 
tend verwenden kénnen. Welche SQL-Kommandos und Datentypen Ihr Datenbankserver unterstiitzt, entnehmen Sie 
bitte dessen Dokumentation. 


Die von der REALDatabase und dem 4th Dimension-Plugin unterstiitzte SQL-Untermenge wird in Anhang A der Sprach- 
referenz (gedruckte und PDF-Version) dokumentiert. 


Hinweis: Wenn Sie ein Front-End fiir einen kommerzielles Back-End schreiben, steht Ihnen wahrscheinlich ein erweiter- 
ter SQL-Sprachumfang zur Verfiigung. Auch wenn Ihr Front-End-Prototyp die REALDatabase verwendet, sollte es ohne 
Anderungen mit einer anderen Datenquelle funktionieren. Nach dem Umstellen der Datenquelle konnen Sie dann den 
zusatzlichen Sprachumfang nutzen und Ihr Front-End an die erweiterten Features anpassen. 


Falls Sie sich bisher noch nicht mit SQL beschéftigt haben, sollten Sie zundchst einige SQL-Grundlagen erlernen, bevor 
Sie mit der Implementierung Ihrer REALbasic-Datenbankanwendung beginnen. Dieses Handbuch unternimmt nicht den 
Versuch, Ihnen SQL beizubringen. Bitte konsultieren Sie statt dessen eines der vielen erhiitlichen SQL-Referenzwerke, 
z.B. SOL fiir Dummies von Allen G. Taylor (ISBN: 3-8266-2787-3) oder das SQL-Tutorial, das Sie online unter folgender 
URL finden: http://w3.one.net/~jhoffman/sqltut.htm. 


Datenbank-Werkzeuge in REALbasic 


Ein Datenbank-Frontend verwendet typischerweise eine Kombination aus datenbankspezifischen und generischen Steu- 
erelementen und Befehlen. 


Mit dem DatabaseQuery und dem DataControl gibt es zwei datenbankspezifische Steuerelemente. AufSerdem stehen 
mehrere datenbankspezifische Klassen und Methoden zur Verftigung. 


Die REALDatabase kann die Tabellen einer Datenbank entweder in einem virtuellen Volume (siehe ,Virtuelle Volumes“ 
auf Seite 299) oder als einzelne Dateien speichern. 


In einer REALdatabase konnen Sie Tabellen hinzuftigen, loschen oder modifizieren (z.B. Felder und Indizes anlegen oder 
léschen), ohne dass davon nicht betroffene Daten verloren gehen oder umkopiert werden miissen. 


Die REALDatabase-Datenbank Engine unterstiitzt verschiedene Textcodierungen. Wenn Sie Datensiatze einftigen, spei- 
chert die Datenbank die Codierung der Textfelder und verwendet diese auch beim Auslesen der Felder automatisch. Es 
ist also im Gegensatz zu den meisten anderen Datenbanken nicht nétig, beim Auslesen von Daten aus einer REALData- 
base die Textcodierung anzugeben. 
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REALDatabase unterstiitzt Transaktionen fiir Anderungen der Daten und der Datenbankstruktur, Eine Transaktion wird 
automatisch initiiert, wenn Sie Anderungen an der Datenbank oder den Daten vornehmen und wird durch einen Aufruf 
von COMMIT oder ROLLBACK abgeschlossen. 

Jede Tabelle in REALDatabase besitzt eine spezielle Spalte namens ,,_rowid“, die einen eindeutigen numerischen Schltis- 
sel fiir jeden Datensatz mitftihrt. Dieser wird automatisch gesetzt und kann auch ftir Verkniipfungen (Joins) verwendet 
werden. 

Keine Tabelle darf gréfer als 2 GB werden. Wenn Sie die Datenbank auf einem virtuellen Volume speichern, darf die 
Gesamtgr6&e der Datenbank 2 GB nicht iiberschreiten. Da, rowid“ mit jedem neuen Datensatz automatisch um eins 
vergrofsert wird und ein einmal vergebener Wert nicht erneut benutzt wird, k6nnen Sie maximal ca. 4 Milliarden Daten- 


satze (234) in eine Tabelle einftigen. 


Auswahl einer Datenquelle 


Sie konnen eine Datenquelle entweder mittels Programmcode auswahlen oder tiber den Meniipunkt Ablage/ 
Datenquelle hinzufiigen zu Ihrem Projekt hinzuftigen. Unter diesem Mentipunkt ist standardmafsig nur die REALdata- 
base aufgeftihrt. Andere Datenbanken erscheinen dort nur, wenn Sie ein entsprechendes Datenbank-Plugin im Plug- 
ins-Ordner innerhalb des REALbasic-Ordners installiert haben. 


Abb. 246: Das Untermenti Datenquelle hinzufiigen 


‘@ Neue REAL Datenbank (Altes Format)... 

@ REAL Datenbank (Altes Format) auswahlen... 
Neue REAL-Datenbank... 

REAL-Datenbank wahlen... 

4D Server 6.8 (TCP/IP)... 

dtF/SQL Database... 


Select MySQL Database... 


ODBC Database... 
OpenBase Database... 
PostgreSQL Database... 


Mit REAL-Datenbank wahlen... dffnet sich ein Dialog, in dem Sie eine vorhandene Datenbank auswahlen k6nnen. 
Der Mentipunkt Neue REAL-Datenbank... zeigt einen Sichern-Dialog zum Anlegen einer neuen Datenbank. 


Die ausgewahlte oder neu angelegte Datenquelle erscheint im Projektfenster, wie in Abbildung 247 zu sehen. 


Abb. 247: Eine Datenbank im Projektfenster 


@®@@ db 


[& Fensterl 


iy Mena 


Angestellte 


Die RealDB ,,Angestellte” 


Hinweis: Sie konnen Datenbanken auch einfach in das Projektfenster ziehen, um sie zum Projekt hinzuzuftigen. 


Sie kénnen eine Datenbank aus dem Projektfenster entfernen, indem Sie sie auswahlen und den Meniipunkt 
Bearbeiten/Léschen aufrufen. 


Selbstverstindlich kénnen Sie eine REALdatabase auch mittels Programmcode 6ffnen. Erzeugen Sie dazu eine Instanz 
der REALdatabase-Klasse und weisen deren DatabaseFile-Eigenschaft den Pfad der Datenbankdatei zu. Rufen Sie dann 
die Methode ,,Connect* auf. Kehrt ,Connect* mit True zurtick, ist eine Verbindung mit der Datenbank hergestellt und Sie 
k6nnen Datenbankoperationen ausftihren. Liefert ,Connect“ hingegen False zuriick, konnte keine Verbindung herge- 
stellt werden. Dann finden Sie in den Eigenschaften ,ErrorCode“ und ,,ErrorMessage“ Hinweise auf die Fehlerursache. 
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Hier ein Beispiel: 
Dim dbFile as FolderItem 
Dim db as REALDatabase 
db=New REALDatabase 
dbFile = GetFolderItem("Pubs") 
db.DatabaseFile=dbFile 
If db.Connect() then 

// Datenbankoperationen bei erfolgreichem Verbindungsaufbau 
else 

Beep 

MsgBox "Fehlermeldung: "+db.ErrorMessage 
end if 


Im Beispiel wird eine Datenbank namens ,,Pubs“ ge6ffnet, die sich im selben Verzeichnis wie REALbasic befindet. Sollte 
sich die Datenbank in einem anderen Verzeichnis befinden, konnen Sie die Volumes-Funktion und die Parent- und 
Child-Eigenschaften der Folderltem-Klasse verwenden, um den Zugriffspfad festzulegen. Beispiele dazu finden Sie im 
Abschnitt ,,Lesen einer Datei an einer vorgegebenen Stelle“ auf Seite 284. 


Zum Erzeugen einer neuen Datenbank gehen Sie fast genauso vor. Der Unterschied besteht darin, dass Sie statt Connect 
die Methode CreateDatabaseFile aufrufen miissen. Wird True zurtickgegeben, wurde die Datenbank erfolgreich erzeugt. 
Hier ist ein Beispiel: 
Dim db as REALDatabase 
Dim f as FolderItem 
f=New FolderItem("meineDatenbank" ) 
db=New REALDatabase 
db.databaseFi le=f 
If db.CreateDatabaseFile then 
//proceed with database operations... 
else 
MsgBox "Error message: "+db.ErrorMessage 
end if 
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Mittels Doppelklick auf eine Datenbank im Projektfenster kGnnen Sie das Schema (die Struktur) der Datenbank éffnen. 
Es wird eine Liste aller Tabellen der Datenbank angezeigt. Ausgehend von dieser Liste kGnnen Sie die eingegebenen 
Daten und die Liste der Felder (Spalten) und Feldattribute betrachten. 


Abb. 248: Das Schema einer Datenbank 


Zeigt eine Liste der Datensatze der 


eee Publikationen Tabellen 7 ausgewahiten Tabelle 
Liste der Tabellen Autoren (Daten ansehen e}—— 
der Datenbank ——® Herausgeber SS ; 
Titel (Schema andern e— Offnet eine editierbare Liste der 


Felder der ausgewahlten Tabelle 


» 


¢ Neue Tabelle @——_ 


Fe 
estonia Offnet einen Dialog zum Neuanlegen 


——— von Tabellen und Feldern 


Bei einer neuen Datenbank ist die Tabellenliste zunachst leer. Eine neue Tabelle wird folgendermafen angelegt: 
1. Klicken Sie auf den Knopf Neue Tabelle in der Dialogbox ,,Neue Tabelle’. 
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Abb. 249: Der Dialog ,,Neue Tabelle” 


Neue Tabelle 


Tabellenname: || ( Indizes... 


Feldname Feldtyp: @ 


Anlege Andern Loschen 


ae = 


2. Geben Sie den Tabellennamen ein und driicken Sie Tab. 


Sie miissen in der Tabelle mindestens ein Feld anlegen. Das Feld ,_rowid“ wird automatisch erzeugt, Sie brauchen es 
nicht explizit anzulegen und konnen an Stelle eines Primirschltissels verwenden. 


3. Unter Feldname geben Sie den Namen des ersten Feldes ein und driicken Tab. Jetzt ist der Knopf ,,Anlegen“ aktiv. 
4, Wahlen Sie aus dem Popup einen Datentyp aus. Die REAL-Datenbank unterstiitzt folgende Datentypen: Integer, Var- 


char, Double, Date, Time, Timestamp, Boolean, String und Binary (Grofse bis zu 2! Bytes). Andere Datenquellen 
unterstiitzen evtl. weitere Datentypen. Beim Versuch, einen von der konkreten Datenquelle nicht unterstiitzten 
Datentyp zu verwenden, erscheint die Meldung Unbekannter Datentyp. 


5. Klicken Sie auf Anlegen, um das erste Feld zu erzeugen. Wenn Sie dann auf OK klicken, erscheint das Feld in der 
Feldliste, wie in folgender Abbildung zu sehen. 


Abb. 250: Die Dialogbox ,,Neue Tabelle” mit einem Feld 


Neue Tabelle 


Tabellenname: Herausgeber ( Indizes... ) 


herausgeber_id Integer Primary key Not null 


Feldname: herausgeber_id| Feldtyp: Integer (3) 
Anlegen Andern (_leschen _) @€igenschaftensa) 


(Abbrechen ) ( OK 


Die REALdatabase unterstiitzt keine Feldattribute wie ,,Mussfeld“ und ,,Primdrschliissel“. Werden diese von einem ande- 
ren Back-End unterstiitzt, konnen Sie sie tiber den Eigenschaften-Knopf aktivieren. 


6. Fiigen Sie der Tabelle durch Wiederholen der Schritte 3 bis 5 weitere Felder hinzu. 


Indizes hinzufiigen 
Nachdem Sie die Felder hinzugeftigt haben, konnen Sie fiir ausgewahlte Felder einen Index anlegen. Indizes beschleuni- 
gen Datenbankzugriffe. 


Beachten Sie: Bestimmte Datenquellen unterstiitzen keine Indizierung. Ftir solche Datenquellen wird im Neue Tabelle/ 
Tabelle bearbeiten-Dialogfeld kein ,.Indizes*-Knopf angezeigt. 
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Sie sollten in jeder Tabelle einen Primiirschltissel und die Felder indizieren, tiber die Sie die meisten Such- und Sortier- 
vorgange ausftihren. Die Abfrage von Informationen und relationale Operationen zwischen Tabellen gehen schneller 
vonstatten, wenn die verwendeten Felder indiziert sind. 


Felder, die nur wenige Werte annehmen kénnen (z.B. Geschlecht oder Anrede), Felder, in denen selten gesucht wird 
und Felder in Tabellen mit wenigen Datensdtzen miissen nicht indiziert werden, da hier die Such- und Sortierzeit nicht 
ins Gewicht falle. 


Sie sollten nicht zu viele Felder indizieren, da jeder Index die Datenbank vergr6fert und die Datenbank zum Aktualisie- 
ren der Indizes Zeit bendtigt, wenn Datensatze hinzugeftigt oder geldscht werden. 


Um Indizes fiir eine Tabelle zu erzeugen, gehen Sie folgendermafsen vor: 
1. Klicken Sie auf den Knopf Indizes in der Tabellen-Dialogbox. 
Hinweis: Falls die Datenquelle keine Indizierung unterstiitzt, erscheint an dieser Stelle kein Indizes-Knopf. 


2. Es erscheint die ,,Indizes bearbeiten-Dialogbox. 


Abb. 251: Die Indizes-Dialogbox 


Indizes bearbeiten 


¢ Hinzufiigen ) 


Losche 


(| Abbrechen ) 


3. Klicken Sie auf Neu..., um die Dialogbox ,Neuer Index“ aufzurufen. 


Abb. 252: Die Dialogbox ,,Neuer Index” 


Neuer Index 


aT 


Address 
City 
Pub_Name 
State 

Zip 


CAbbrechen) GOD 


4. Selektieren Sie das erste zu indizierende Feld und klicken Sie auf den Rechtspfeil oder fithren Sie einen Doppelklick 
auf das Feld aus, um es in die rechte Spalte zu iibernehmen. 

5. Optional: Um einen zusammengesetzten Index (einen Index tiber zwei oder mehr Felder) zu erzeugen, tibernehmen 
Sie weitere Felder in die rechte Liste. Z.B. kGnnten Sie in einer Adresstabelle einen zusammengesetzten Index aus 
den Feldern Nachname und Vorname erzeugen, damit die Datenbank schnell zwischen verschiedenen Personen mit 
dem gleichen Nachnamen unterscheiden kann. 


6. Geben Sie dem Index im oberen Eingabefeld einen Namen. Folgende Abbildung zeigt einen ,,fertigen“ Index. 
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Abb. 253: Der Index fiir das Publikationen-Primarschlisselfeld 


Neuer Index 


Publikationen Primary Key 


Kontrakt pub_id 


(Abbrechen ) ES 50K) 


7. Klicken Sie auf OK, um den Index in die Datenbank zu tibernehmen. 


Es erscheint wieder die Dialogbox ,,Indizes bearbeiten“ und zeigt den Namen des neu erzeugten Index. 


8. Optional: Klicken Sie auf Neu..., um weitere Indizes zu erzeugen und wiederholen Sie die Schritte 4 bis 7. 


Datensatze anzeigen 


Der Knopf ,,Daten ansehen“ im Datenbankschema-Dialog (Abbildung 248 auf Seite 337) zeigt eine Liste mit den Daten- 
sdtzen der gewahlten Tabelle. Der Dialog akzeptiert eine SQL-Abfrage (SQL-Query), die Sie an die Datenbank richten 
konnen. Die standardmafsig vorgegebene SQL-Abfrage zeigt alle Datensatze der Tabelle an. Sollen nur bestimmte Daten- 
sdtze angezeigt werden, konnen Sie dazu eine WHERE-Bedingung formulieren. Sollen nur bestimmte Felder angezeigt 
werden, kGnnen Sie diese an Stelle des ,,*“ auflisten. Mit ORDER BY kGnnen Sie dariiber hinaus eine Sortierung nach 
einem oder mehreren Feldern festlegen. 


Datentypen fiir Datenbankfelder 


Unten sehen Sie eine Aufstellung der von der REALdatabase unterstiitzten Datentypen. 


Hinweis: Welche Datentypen Sie in einer konkreten Datenbank verwenden kénnen, ist von der jeweiligen Daten- 
bank-Engine abhangig. Native SQL-Datenbanken konnen weitere Datentypen unterstiitzen. Welche das sind, konnen Sie 


der Dokumentation Ihres Datenbankservers entnehmen. 


Tabelle 36. Von der REALdatabase unterstiitzte Datentypen 


Feldtyp 
Integer 


Text 
oder VarChar 


Double 


Date 


Time 


Numerischer 
Code 


3 


Beschreibung 

Numerischer Ganzzahl-Datentyp. Die maximale Stellenanzahl ist implementierungsabhangig. 
Die REALdatabase verwendet 4-Byte-Integer-Werte (Wertebereich +2,000,000.000). 

Fiir andere Datenquellen konsultieren Sie bitte deren Dokumentation. 
Speichert Textdaten, bei denen die Anzahl der Zeichen von Datensatz zu Datensatz variiert, 
ungenutzte Zeichen aber nicht mit Leerzeichen tiberschrieben werden. VARCHAR(20) legt also 
ein VARCHAR-Feld mit der Maximallange von 20 Zeichen an. 
Die REAL-Database unterstiitzt den VarChar-Feldtyp, nicht den Text-Typ. Die theoretische Maxi- 
mallinge eines VarChar-Feldes betriigt 2°! Bytes. Wenn Sie in einem CREATE TABLE oder ALTER 
TABLE-Befehl eine Maximallange festlegen, wird diese ignoriert. 


Speichert FlieSkommazahlen mit doppelter Genauigkeit. Die REAL-Database verwendet 8-Byte 
Doubles. 

Speichert Jahr, Monat und Tag eines Datums im Format JJJJ-MM-TT. 

Speichert die Stunden, Minuten und Sekunden einer Uhrzeit im Format HH:MM:SS. Die Stun- 
den und Minuten sind zweistellig. Die Sekunden sind auch zweistellig, konnen aber einen optio- 
nalen Nachkommateil haben, z.B. 09:55:25.248. Die Standardlange des Nachkommateils ist 0. 
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Tabelle 36. Von der REALdatabase unterstiitzte Datentypen 


Numerischer 
Feldtyp Code Beschreibung 


TimeStamp 10 Speichert Datum und Uhrzeit im Format JJJJ-MM-TT HH:MMSSS. 

Die Einzelkomponenten entsprechen den Datentypen Date und Time mit dem Unterschied, 
dass der Nachkommateil der Sekunden standardmafig 6 und nicht 0 Stellen lang ist. Wenn ein 
TimeStamp-Wert keinen Nachkommaanteil hat, ist er 19 Stellen lang. Verfiigt er tiber einen 
achkommaanteil, ist seine Lange 20 Stellen plus die Anzahl der Nachkommastellen. 

Boolean 12 Speichert die Werte von TRUE und FALSE. 

Binary 14 Speichert Code, Bilder und hexadezimale Daten. Schlagen Sie in der Dokumentation Ihrer 
Datenquelle nach, um die maximale Lange des Binary-Feldes zu erfahren. Die REALdatabase 


speichert bis zu 2°! Bytes. 
String 18 Bis zu 2°" Bytes Text. Identisch mit VarChar, 


Die REALdatabase unterstiitzt ein Fluchtsymbol (,,.Escape Character“) in Zeichenketten. Ein Fluchtsymbol entwertet ein 
direkt darauf folgendes Sonderzeichen und sorgt dafiir, dass dieses als normales Zeichen gewertet wird. Das Fluchtsym- 
bol kann mittels SET ESCAPE frei definiert werden. Z.B. stellt ,SET ESCAPE p“ den Backslash als Fluchtsymbol ein. Mit 
»SET ESCAPE* ohne Argument wird das Fluchtsymbol wieder deaktiviert. 


Das DatabaseQuery Steuerelement 


Das DatabaseQuery Steuerelement kann verwendet werden, um Abfragen an die Datenquelle zu senden. Alternativ kon- 
nen Sie diese Funktion auch ,von Hand“ programmieren. 


Ein DatabaseQuery kann wie jedes andere Steuerelement aus der Steuerelementepalette auf ein Fenster gezogen wer- 
den. Im Unterschied zu den meisten anderen Steuerelementen ist es allerdings ftir den Anwender nicht sichtbar. 


Abb. 254: Das DatabaseQuery Steuerelement 


Tabelle 37. Eigenschaften von DatabaseQuery 


Name Beschreibung 
Database Die Datenquelle, an die eine Abfrage gestellt wird. 
SQLQuery Der Text der SQL-Abfrage, die Uber Database ausgefihrt werden soll. 


SOLQuery wird automatisch ausgefiihrt, wenn das Fenster dargestellt wird. Die in Abbildung 255 gezeigten Eigenschaf- 
ten fordern beispielsweise alle Zeilen und Spalten der Titel-Tabelle an, sobald das Fenster ge6ffnet wird. Allerdings ist 
das DatabaseQuery nicht in der Lage, die Zeilen und Spalten ohne fremde Hilfe darzustellen. 


Abbildung 255. Die Eigenschaften eines DatabaseQuery Steuerelements: 


(3) Eigenschaften 


Name: DatabaseQueryl 
Index: 
Super: DatabaseQuery v 


ControlOrder: 0 
Left: 104 
Top: 51 


SQLQuery: select * from Titel @ 
Database: Herausgeber v 


DatabaseQuery verfiigt tiber die Methode RunQuery, die SQLQuery auf Database anwendet. 
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DatabaseQuery und Objektverkniipfungen 


Mit dem DatabaseQuery-Steuerelement und Objektverkniipfungen konnen Sie ein einfaches Datenbank-Frontend 
zusammenbauen, ohne eine einzige Zeile programmieren zu miissen. 

Da SQLQuery automatisch vom DatabaseQuery-Steuerelement ausgefiihrt wird, mtissen Sie sich nur noch um das Anzei- 
gen des Ergebnisses ktimmern. Erzeugen Sie zu diesem Zweck eine ListBox im Fenster und verkntipfen Sie Database- 
Query- und ListBox-Steuerelement miteinander. Halten Sie dazu die Shift- und Befehlstaste (Windows: Shift und Strg) 
gedriickt und ziehen Sie eine Verbindungslinie zwischen den Steuerelementen. Der Dialog ,Neue Objektverkniipfung“ 
erscheint. Wahlen Sie die Aktion Verbinden Sie ListBoxl mit den Listendaten von DatabaseQueryl.... 


Bei Aufruf von Debug/Programm starten erscheinen die Datensiitze in der ListBox, wie in Abbildung 256 gezeigt.! 


Abb. 256: Eine einfache Datenbank ohne Programmierung 


oO Untitled ==) =| o Untitled 8 
a 

| 1D | Jobtitie | Name 

hed 1 vP Lois Lane “= 

E 2 Reporter Jimmy Olson 
3 Editor Perry White 

- 4 Receptionist Lana Lang 
+ 


“a 


Entwicklungsumgebung Laufzeitumgebung 


Genauso kénnen Sie ein DatabaseQuery-Steuerelement mit einem Popup-Menii verkniipfen. Das Popup-Menti wird 
dann mit den Ergebnissen der Abfrage gefiillt. Sie kénnen anders herum auch das Popup mit dem 
DatabaseQuery-Steuerelement verkntipfen, so dass Sie im Popup durch Auswahl eines anderen Eintrags die Abfrage 
modifizieren konnen. Abbildung 257 illustriert dieses Konzept: 


Abb. 257: Verwenden einer Objektverkniipfung, um die Eintrage eines PopupMenu-Steuerelements zu belegen 


o Untitled 


DatabaseQuery2 ———+ 


Das ausgewdhlte DatabaseQuery Steuerelement enthalt folgende SQL-Abfrage im Eigenschaftenfenster: 


Select name, ident from airports 


1. Die Spaltentiberschriften wurden im Eigenschaftenfenster der ListBox eingegeben. 
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Abb. 258: Die SQL-Abfrage, die das PopupMenu mit Daten belegt 


SQLQuery 
Database 


Bind Popup Menul with list data 


[=] 
DatabaseQuery2 
DatabaseQuery 
198 
191 
select name, ident fromairport [J L 
[=I 


jenschaften 


AirportsDB 


Die SQL-Abfrage extrahiert einen Namen und eine ID aus der Datenbank. Die Verkntipfung trdgt den Namen in das 
PopupMenu ein und weist der unsichtbaren RowTag-Eigenschaft die ID zu. Die RowTag-Eigenschaft ist eine unsichtbare 
Spalte, die als Erkennungsmerkmal (Identifier) benutzt werden kann. 

Die Verkniipfung mit dem PopupMenu-Steuerelement lautet: 

from DatabaseQuery’s results 

Die Verkniipfung des PopupMenu-Steuerelements mit dem anderen DatabaseQuery lautet: 


Bind DatabaseQueryl parameter with string data from PopupMenul RowTag 


Diese iibergibt den Wert der RowTag-Eigenschaft des PopupMenus an das DataBaseQueryl. Dieser Wert wird im 


SQL-Ausdruck des DatabaseQuery-Steuerelements verwendet: 


Abb. 259: Die SQL-Abfrage, die die ListBox mit Daten belegt 


SQLQuery 
Database 


Eigenschaften 


=| 
DatabaseQuery 1 
DatabaseQuery 
104 
149 
select * fromairport where ident="% 1" 
AirportsDB 5 


Der SQL-Befehl ,,select * from airport where id=’%1" enthalt den Parameter %1, dem der RowTag-Wert des im Popup- 
Menu selektierten Eintrags zugewiesen wird, also die ID der vom Anwender ausgewahlten Stadt. 


Mit anderen Worten: Diese Abfrage selektiert alle Spalten fiir die ausgewahlte Stadt, verwendet daftir aber die unsicht- 


bare Spalte an stelle des Namens der Stadt. 


Die letzte Verkntipfung verkniipft die Ergebnisse des DatabaseQuery mit der ListBox: 
Bind listBoxl with list data from DatabaseQueryl results 


Ein Beispiel ist in Abbildung 260 zu sehen. 


Abb. 260: Eine einfache Datenbank, die nur Objektverkniipfung verwendet 
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Das DataControl Steuerelement 35 


Mit dem DataControl-Steuerelement konnen Sie sehr einfach eine leistungsfahige Eingabemaske fiir eine Datenbankta- 
belle erzeugen. Das DataControl-Steuerelement ist ein einzelnes Objekt, das aus Navigationskndpfen fiir die Datensatze 
(erster, letzter, nachster und voriger Datensatz) und einer Beschriftung besteht. 

e808 Namenlos 

] 14| 4 | Beschriftung aL | 


Ein DataControl-Steuerelement platzieren Sie auf einem Fenster, das EditFields, ListBoxes, Popup-Meniis oder Static- 
Text-Steuerelemente verwendet, um Daten anzuzeigen und zu bearbeiten. Das DataControl-Steuerelement kann aber 
auch als Datenquelle fiir Klassen, die sich von diesen Steuerelementen ableiten, dienen. Diese Steuerelemente besitzen 
zwei Eigenschaften, DataSource und DataField, die nur in Verbindung mit einem DataControl verwendet werden. Diese 
werden im unteren Bereich des Eigenschaftenfensters aufgefiihrt: 


DataSource: DataControl1 ws 
DataField: feld1 vw 


Die DataSource-Eigenschaft enthalt den Namen des DataControl-Objekts im Fenster. Das DataControl-Objekt wie- 
derum ist tiber die Eigenschaften Database und TableName mit einer Datenbank-Tabelle verbunden: 


Database: AddressBook Ww 
TableName: contacts w 

SQLQuery: Select * from contacts @ 

ReadOnly: (| a 

Commit: iA r 


In obiger Abbildung ist das DataControl mit der Tabelle contacts“ der Datenbank ,,AddressBook* verbunden. Sobald Sie 
die Datenbank ,,AddressBook* ausgewdhlt haben, k6nnen Sie aus dem Popup unter TableName eine der in AddressBook 
vorhandenen Tabellen auswahlen. 

Die DataField-Eigenschaft enthalt den Namen des Datenfeldes der contact-Tabelle, dessen Inhalt in diesem EditField 
anzeigt wird. Bei Verwendung der Datensatz-Navigationskndpfe zeigt das DataControl automatisch den Wert dieses Fel- 
des im EditField an. 

Auf diese Weise verkntipfen Sie alle Steuerelemente der Eingabemaske mit dem DataControl und das DataControl mit 
einer Tabelle der Datenbank. 


Folgende Aktionen kénnen Steuerelementen mittels Objektverkniipfung zugewiesen werden: 


Die Insert-Verknitipfung fiigt den im Fenster gezeigten Datensatz in die Tabelle ein. 
Die Update-Verkniipfung speichert Anderungen an einem Datensatz in der Datenbank. 
Die New-Verkniipfung ldscht die Inhalte aller Steuerelemente. 


e 
e 
e 
© Die Delete-Verkniipfung léscht den Datensatz aus der Tabelle. 
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Diese Operationen sind in folgender Tabelle zusammengefasst: 


Tabelle 38. Objektverkniipfungen mit dem DataControl-Steuerelement 


Quellobjekt Verfiigbare Objektverkniipfung 


PushButton Fuigt Datensatz ein, wenn der PushButton gedrtickt wird. 
Aktualisiert Datensatz, wenn der PushButton gedriickt wird. 
Loscht Datensatz, wenn der PushButton gedriickt wird. 
Neuer Datensatz, wenn der PushButton gedriickt wird. 


BevelButton Fuigt Datensatz ein, wenn der BevelButton gedriickt wird. 
Aktualisiert Datensatz, wenn der BevelButton gedriickt wird. 
Loscht Datensatz, wenn der BevelButton gedriickt wird. 
Neuer Datensatz, wenn der BevelButton gedrtickt wird. 


RadioButton Fuigt Datensatz ein, wenn der RadioButton selektiert wird. 
Aktualisiert Datensatz, wenn der RadioButton selektiert wird. 
Loscht Datensatz, wenn der RadioButton selektiert wird. 
Neuer Datensatz, wenn der RadioButton selektiert wird. 
Fuigt Datensatz ein, wenn der RadioButton deselektiert wird. 
Aktualisiert Datensatz, wenn der RadioButton deselektiert wird. 
Loscht Datensatz, wenn der RadioButton deselektiert wird. 
Neuer Datensatz, wenn der RadioButton deselektiert wird. 


CheckBox Fuigt Datensatz ein, wenn die CheckBox angewahlt wird. 
Aktualisiert Datensatz, wenn die CheckBox angewadhlt wird. 
Loscht Datensatz, wenn die CheckBox angewahlt wird. 
Neuer Datensatz, wenn die CheckBox angewahlt wird. 
Fiigt Datensatz ein, wenn die CheckBox abgewahlt wird. 
Aktualisiert Datensatz, wenn die CheckBox abgewahlt wird. 
Loscht Datensatz, wenn die CheckBox abgewahlt wird. 
Neuer Datensatz, wenn die CheckBox abgewahlt wird. 
Aktiviert DataControl, wenn CheckBox angewahlt ist. 


Mittels Objektverkniipfung konnen Sie Kndpfe auf der Eingabemaske mit diesen Schltisseloperationen belegen, ohne 
daftir Code schreiben zu miissen. Hier ein Beispielfenster, das zur Dateneingabe bereit ist: 


eee Address Book 

First Name URL email 

Last Name phone 

Company fax 

Address [ 

Address Cont. 

City [ a Description 0) 

State 

Zip 

——————— a 

Country ’ 
Primarschliissel| ———s———_— 5 SS ) 

[14] 4 | Contacts D> >I 


Damit das DataControl korrekt mit der Datenquelle zusammen arbeiten kann, muss die Tabelle ein Primdrschliisselfeld 
besitzen. Ein Primarschliissel ist eindeutig und darf nicht leer sein. 
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Wenn Sie als Datenquelle die REALdatabase verwenden, brauchen Sie keinen Primarschliissel zu erzeugen, da jede 
Tabelle einer REALdatabase automatisch einen Primarschltissel namens _rowID enthalt. Das _rowID-Feld ist eine ein- 
deutige, sequentiell aufsteigende Datensatznummer, die von der REALdatabase-Datenbank Engine automatisch verge- 
ben wird. Wenn Sie eine andere Datenbank als Datenquelle verwenden, sollten Sie fiir den Primdrschliissel eine 
fortlaufende Nummer erzeugen. Legen Sie dazu ein EditField- oder StaticText-Steuerelement an, das mit dem Primar- 
schliisselfeld der Tabelle verkniipft ist und schreiben Sie folgenden Code in den Validate-Event des DataControls: 
Function Validate(action as Integer) as Boolean 
Dim dbc as DatabaseCursor 
If action = me.kAddNew then 
dbc = Me.database.SQLSelect("Select Max(id) from " + me.tableName) 
idfield.text = Str(dbc.idxField(1).integerValue + 1) 
end if 
End Function 


Dieser Code geht davon aus, dass das Primarschliisselfeld den Namen ,,id“ besitzt und mit dem Steuerelement ,,idfield“ 
verkniipft ist. 


Programmieren eines Datenbank-Frontends 


Um die Datenbankfunktionen von REALbasic auszureizen, kommen Sie nicht umhin, ein wenig Programmcode zu 
schreiben. Die Befehle, die im Datenbank-Teil der Sprachreferenz beschrieben werden, versorgen Sie mit allen notwen- 
digen Werkzeugen, um anspruchsvolle Datenbank-Frontends zu entwickeln. 


Auswahl einer Datenquelle 


Die folgenden Klassen erlauben Ihnen die Auswahl der Datenbank-Backends, die in ihrer Applikation verwendet werden 
sollen. Mit Ausnahme der REAL-Datenbank setzt jede Methode voraus, dass das passende REALbasic-Plugin im Plug- 
ins-Ordner installiert ist. Alle Datenbank-Plugins werden zusammen mit REALbasic geliefert. Datenbank-Plugins werden 
haufiger aktualisiert als REALbasic selbst. Die neuesten Versionen finden Sie immer unter www.realsoftware.com. 


Tabelle 39. Klassen zum Zugriff auf Datenquellen 


Database-Unterklasse Beschreibung 


ADSP4DServer Wird statt Open4DDatabasebyADSP verwendet. 

MySQLDatabase Unterstiitzung von MySQL-Datenbanken. 

ODBCDatabase Wird statt OpenODBCDatabase verwendet. 

OpenBaseDatabase Wird statt OpenOpenBaseDatabase verwendet. 
OpenOracleDatabase Sorgt fir die Unterstiitzung von Oracle 8-9i unter Mac OS X. 
PostgreSQLDatabase Wird statt OpenPostgreSQLDatabase verwendet. 

REALDatabase Wird statt Open4DDatabasebyTCPIP verwendet. 

TCPIP4DServer Offnet eine 4th Dimension Datenbank unter Verwendung von ADSP. 


Frontbase kann ebenfalls verwendet werden. Unterstiitzung hierfiir wird durch ein Plugin eines Drittanbieters bereitge- 
stellt. Dieses Plugin ist frei verfiigbar und befindet sich auf der REALbasic CD. 


Da die oben genannten Klassen von der Database-Klasse abgeleitet wurden, stellen sie sowohl einen Standardbefehlssatz 
als auch von der konkreten Datenquelle abhangige Befehle zur Verftigung. 


Weitere Informationen tiber die neuen Unterklassen der Database-Klasse finden Sie in der Sprachreferenz. 


Wenn Sie eine Datenquelle 6ffnen, sollten Sie zunachst testen, ob die Verbindung erfolgreich aufgebaut werden konnte, 
bevor Sie Datenbankoperationen ausftihren. Verwenden Sie dazu die Connect-Methode der Database-Klasse. Liefert 
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diese True zurtick, konnte die Verbindung hergestellt werden. Wird False zurtickgeliefert, konnen Sie anhand der Error- 
Message- und ErrorCode-Eigenschaften der Database-Klasse Riickschliisse auf die Fehlerursache ziehen. 


Der folgende Code 6ffnet eine 4D Server-Datenbank der Version 6.7 tiber TCP/IP: 


Dim db as TCPIP4DServer67 
db = New TCPIP4DServer6/ 
db.host = "127.0.0.1" 
db.username = "me" 
db.password = "test" 
If db.connect() then 
//an dieser Stelle kénnen Sie Anderungen an Ihrer Datenbank vornehmen 
else 
MsgBox "Connection failure!" 
end if 


Mit Ausnahme von OpenCSVCursor liefern diese Methoden ein Objekt vom Typ Database zuriick. Tabelle 40 zeigt die 
Methoden der Database-Klasse. 


Tabelle 40. Methoden der Database-Klasse 


Name Parameter Beschreibung 
Close SchlieBt die Datenbank. 
Commit Sichert Anderungen von Datensatzen in der Datenbank. Wenn Sie die 


Anwendung beenden, nachdem Sie Anderungen an einem RecordSet 
vorgenommen haben, fiihrt REALbasic von sich aus den Commit-Befehl aus. 
Verwenden Sie Commit und Rollback, um Transaktionen zu verarbeiten. 
Connect Stellt die Verbindung zum Datenbank-Server her und 6ffnet die Datenbank 
fiir den Zugriff. Liefert ein Boolean. Bevor Sie mit Datenbankoperationen 
fortfahren, sollten Sie testen, ob der Connect-Befehl True zurtickliefert. 
FieldSchema — Tabellenname als String _Liefert ein RecordSet mit Informationen zu allen Feldern in der Tabelle. 


InsertRecord _— Tabellenname als String, Figt ,,.Daten” in die letzte Zeile von ,,Tabellenname” ein. 


Daten als 
DatabaseRecord 
Property Name als String Gibt die Datenbank-Eigenschaft ,, Name” der Datenquelle aus. Wird derzeit 
nur ftir 4D Server untersttitzt. 
Rollback Bricht Transaktionen ab, ohne die Anderungen in der Datenbank 
abzuspeichern. 
SQLSelect SelectString als String SQL Select-Befehl. Liefert ein RecordSet zurtick. 


SQLExecute ExecuteString als String Ein auszuftihrender SQL-Befehl. Wird verwendet, um SQL-Befehle 
auszufthren, die kein RecordSet zurtickliefern. 


Die Methode SQLSelect kann an Stelle eines DatabaseQuery-Steuerelements verwendet werden, um Abfragen an die 
Datenbank zu richten. Die SQLExecute-Methode kann statt des Datenbank-Schema-Dialogs verwendet werden, um eine 
Datenbankstruktur zu erzeugen (und auch viele andere Operationen ausfiihren). Beispielsweise kann folgender Befehl 
verwendet werden, um eine Tabelle zu erzeugen: 


Dim db as Database 


db.SQLExecute("create table authors(au_id integer not null, au_fname varchar, au_Iname varchar, 
address varchar, city varchar), state varchar, zip varchar, phone varchar, primary key (id)") 
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Editieren von Datensatzen 


Die SQLSelect-Methode liefert ein Objekt des Typs RecordSet. In der Terminologie von SQL entspricht das einem Daten- 
bank-Cursor. Friihere REALbasic-Versionen haben ftir diesen Zweck von der DatabaseCursor-Klasse Gebrauch gemacht. 
Funktionen, die vorher einen Datenbank-Cursor ausgegeben haben, liefern jetzt ein RecordSet. 


RecordSets enthalten Datensatze, die das Selektionskriterium erfiillen, das durch die WHERE-Bedingung des 
SELECT-Befehls vorgegeben wurde. AuSerdem werden die im RecordSet enthaltenen Datensdtze in Multi-User-Umge- 
bungen vor Anderungen durch andere Anwender geschiitzt. Die Datensitze eines RecordSets kénnen angezeigt oder 
bearbeitet werden. Mehrere Datensatze konnen nur nacheinander, nicht gleichzeitig bearbeitet werden. Die Eigenschaf- 
ten und Methoden des RecordSet-Objekts konnen Sie in der Sprachreferenz nachschlagen. 


Wenn ein SQL-Befehl ein RecordSet zuriickliefert, hat der Anwender das ,,.Recht“, die Datensdtze des RecordSets exklusiv 
anzusprechen. Wenn das RecordSet mehrere Datensatze enthilt, konnen die Eigenschaften und Methoden des Record- 
Sets verwendet werden, um seine einzelnen Zeilen und Spalten anzusprechen. 


Nachdem eine Abfrage mit der SQLSelect-Methode durchgefiihrt wurde, enthalt das RecordSet einen Zeiger auf den 
aktuellen Datensatz (normalerweise auf den ersten Datensatz im Recordset). Sie konnen die Eigenschaften BOF (Begin- 
ning Of File) und EOF (End Of File) der RecordSet-Klasse verwenden, um zu ermitteln, ob sich der aktuelle Datensatz- 
zeiger vor dem ersten oder hinter dem letzten Datensatz befindet. So kdnnen Sie feststellen, ob die SQLSelect-Methode 
iiberhaupt Datensdtze gefunden hat. Wenn Ihre Abfrage keine Datensatze gefunden hat, sind sowohl BOF als auch EOF 
True, da der aktuelle Datensatzzeiger auf nichts zeigt. 


Wenn Ihre Abfrage mehr als einen Datensatz findet, sind sowohl BOF als auch EOF False, da der aktuelle Datensatzzeiger 
auf den ersten Datensatz zeigt und nicht auf den Anfang oder das Ende der Datei. Wenn Ihre Abfrage zum Beispiel drei 
Datensatze gefunden hat, wiirde das RecordSet folgendermafSen aussehen: 

BOF 

Record] (der aktuelle Datensatzzeiger zeigt auf diesen Datensatz) 

Record2 

Record3 

EOF 

Wenn der Datensatzzeiger auf einen Datensatz verweist, kGnnen Sie diesen mit den Edit- und Update-Methoden modifi- 
zieren bzw. mit der DeleteRecord-Methode ldéschen. Um den Datensatz zu modifizieren, rufen Sie zunachst die 
Edit-Methode auf und fiihren dann die Anderungen aus. 


Um den Wert eines einzelnen Tabellenfeldes zu erfahren oder diesen zu setzen, verwenden Sie die Value-Eigenschaft der 
DatabaseField-Klasse. Da die Value-Eigenschaft ein Variant ist, konnen Sie sie mit jedem beliebigen Feld verwenden. Um 
den Wert eines Feldes auf Nil zu setzen, weisen Sie der Value-Eigenschaft dieses Feldes den Wert Null zu. 

Sind die Anderungen an einem Datensatz abgeschlossen, rufen Sie die Update-Methode auf, um das RecordSet zu aktua- 
lisieren. Sind die Anderungen am RecordSet abgeschlossen, rufen Sie die Commit-Methode des Database-Objekts auf, 
um die Modifikationen in der Datenbank zu speichern. Sollen die Anderungen hingegen doch nicht gespeichert wer- 
den, miissen Sie Rollback aufrufen. 

Die EOF-Eigenschaft nimmt den Wert True an, wenn Sie versuchen, den Datensatzzeiger tiber den letzten Datensatz hin- 
aus zu bewegen 


Wenn Sie nicht explizit Commit aufrufen, wird REALbasic dies implizit beim SchliefSen der Datenbank erledigen. 
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Datensatze einfiigen 


Ein neuer Datensatz wird unter Verwendung der InsertRecord-Methode des Database-Objekts eingefiigt. Diese Methode 
hat zwei Parameter: Das Database-Objekt und ein Objekt vom Typ DatabaseRecord. 


Tabelle 41. Eigenschaften von DatabaseRecord 


Name Typ Beschreibung 
Column Name als String Spalte der aktuellen Tabelle. 


Der folgende Code fiigt in der ,Mitarbeiter“-Tabelle einen Datensatz ein: 


dim db as Database 


dim rec as DatabaseRecord 
rec = New DatabaseRecord 


rec.Column("au_id") = "09" 
rec.Column("au_fname") = "Oscar" 
rec.Column("au_lame" )="Wilde" 
db. InsertRecord("authors", rec) 


Weitere Informationen und Beispiele finden Sie in der Sprachreferenz unter RecordSet, DatabaseField und bei den 
Datenbankklassen. 
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xitet1 _ Debugging lhres Codes 


Ware es nicht schon, wenn jede Programmzeile sich so verhalten wiirde, wie Sie es m6chten? Und das auch noch ohne 
einen einzigen Fehler? Falls sich Ihre Programme einmal nicht so verhalten, bietet Ihnen REALbasic Werkzeuge, um den 
Fehlern auf die Schliche zu kommen und sie zu beheben. 


Inhalt 


Was ist Debugging“? 

Der Debugger und Breakpoints 

Die Ausftihrung von Methoden verfolgen 
Beobachten von Variablen und Eigenschaften 
Unterbrechen des Programms 

Abfangen von Runtime Exception Fehlern 
Remote Debugging 


Was ist , Debugging”? 


Debugging bedeutet, sowohl logische als auch Syntax-Fehler aus dem Programmcode zu entfernen. Fehler im Pro- 
grammcode werden oft auch als ,,bugs“ (engl. fiir ,,Kafer“) bezeichnet. Méglicherweise fragen Sie sich, warum Fehler so 
genannt werden. In der Steinzeit der Computergeschichte, den 40er Jahren des 20. Jahrhunderts, baute man Computer, 
die eine ganze Lagerhalle ausfiillten. Wichtige Bauelemente der Rechner waren damals Vakuum-RGhren. Das Licht dieser 
Vakuum-Rohren zog auch Motten und Kafer an, die dann im Computer herumschlichen und dort Kurzschliisse an den 
Réhren auslésten. Daraufhin mussten Techniker in den Computer gehen (!) und die Kafer entfernen, damit der Compu- 
ter wieder funktionierte. Da es sich damals um Regierungsprojekte handelte, musste alles protokolliert werden, so dass 
die Techniker ins Protokoll ,debugging computer“ (,,Kafer entfernen“) schrieben. Ende der Geschichtsstunde. 


Debugging ist ein Teil des Programmierens. Es ist der Teil, den die meisten Programmierer am wenigsten mogen. REAL- 
basic macht Ihnen die Fehlersuche gliicklicherweise einfach. REALbasic enthalt einen Debugger, der Ihnen in speziellen 
Fenstern zeigt, was gerade schiefgeht. 


Logische Fehler 


Dies sind Fehler im logischen Programmablauf. Sie wissen, dass Sie so einen Fehler gefunden haben, wenn Ihr Pro- 
grammcode ,,etwas“ macht, aber ,,etwas anderes“ hatte machen sollen. Der eingebaute Debugger von REALbasic hilft 
Thnen bei der Suche, indem Sie jede Zeile Ihres Programmcodes einzeln ausftihren und die Reaktionen darauf beobach- 
ten konnen. 


Syntax-Fehler 


Dies sind Fehler, bei denen Sie sich bei der Eingabe des Namens einer Klasse, einer Eigenschaft, Variable oder Methode 
vertippt haben. Es kann auch sein, dass Sie probiert haben, zwei Variablen zusammen zu verwenden, die nicht zusam- 
menarbeiten kénnen. Wenn Sie beispielsweise einer Integer-Variable einen String-Wert zuweisen méchten, bekommen 
Sie einen ,/Iype Mismatch error“, da es sich um zwei verschiedene Datentypen handelt. REALbasic macht es einfach, Syn- 
tax-Fehlern auf die Spur zu kommen. Sobald Sie im Menii Debug/Programm starten (8€-R oder Strg-R) ausfiihren, 
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priift REALbasic Ihren Programmcode auf Syntaxfehler und bemdngelt diese, statt das Projekt zu compilieren. Sie miis- 
sen diese Fehler beheben, bevor Thr Projekt ablaufen kann. Abbildung 261 zeigt ein Beispiel eines solchen Fehlers. 
Abb. 261: Eine Syntax-Fehlermeldung 


eee Code Editor (Fenster1) 
> (@ Eigenschaften Sub Action() 

> @ Events Dim ID As Integer 

> Fy Menu-Handler (D="David" 

> B Methoden Falscher Typ _ (Hilfe) 

> EB Notizen 


¥ G@ Steuerelemente 
VY @ PushButton1 | 


™\ GotFocus 
“ LostFocus Y 


ff EF] + » 


> 


REAlbasic hebt den ersten Fehler hervor, den der Compiler findet. REALbasic markiert die fehlerhafte Zeile und zeigt ein 


Tippsfenster mit der Fehlermeldung an. Der oben gezeigte Fehler trat auf, weil die Variable ID als Integer definiert ist, 
der Programmierer aber versucht hat, ihr einen String zuzuweisen. 


Rechts neben der Fehlermeldung befindet sich ein ,,Hilfe“-Knopf. Wenn Sie den ,Hilfe“-Knopf anklicken, wird der ent- 
sprechende Eintrag der Online-Hilfe mit einer Beschreibung der Fehlermeldung aufgerufen. 


800 __Sprachreferenz : = 
ej Cae 
[Alpha —[iathemeny Falscher Typ Fehler 

Die Kiassen-Hie... 


Tritt auf, wenn Sie versuchen, einen Parameter mit falschem Datentyp zu Ubergeben oder in einem 
Hilfe Zuweisungsbefehl einen falschen Datentyp verwenden. 


Konventionen 0 Beispiele 
Uberblick 

> Fehlerbehandlung 

¥ Fehlermeldungen 
Abstrakte Klasse. | 
‘Array Methoden... | 
Amraygrenzen k... 
Arrays mit Obje... 
Ausdruck erwart... 
Bezeichner erwa... 
Boole'sche Array. Siehe auch 
Die Instanz-Vari.. Unbekannter Typ Fehler. 

’ 


String eine Integer-Variable zuzuweisen: 
nas Integer 
Anton” 


tion, die einen Integer erwartet, Strings zu Ubergeben: 


uzuweisen und nicht einem Element des Arrays. 


Dim mano 


Bei gr6feren Projekten ist es meist sinnvoll, eine Liste mit allen Syntax-Fehlern auf einmal zu erhalten. Klicken Sie dazu 
auf REALbasic/Einstellungen bzw. Bearbeiten/Einstellungen und aktivieren auf der Dialogseite ,,Erzeugen-Prozess“ 
die Option ,, Alle Compiler-Fehlermeldungen zeigen“. 


Abb. 262: ,,Alle Compiler-Fehlermeldungen zeigen” im Einstellungen-Dialog 


REALbasic IDE Voreinstellungen 


‘|o ™ Nach dem Erzeugen: 


w Erzeugte Applikationen auf Disk zeigen 
Tips-Fenster 


D> Malle Compiler-Fehlermeldungen zeigen 


Erzeugen-Proze& 


as 


Drucken 


® 


Debugger 


Dann werden alle Fehler in einem Fehlerfenster angezeigt und nicht mehr als Tipps im Code-Editor. 
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Abb. 263: Das Fehlerfenster 


eee Fehler 


* Diese Methode oder Eigenschaft existiert nicht in Window] .Socket1 .DataAvailable, line 2: 
me.writen "Roger that, | got something from you" 


* Diese Methode oder Eigenschaft existiert nicht in Window] .PushButton1 .Action, line 1: 
socket] (curSocket).porrt = 2002 


* Diese Methode oder Eigenschaft existiert nicht in Window1.PushButton1 .Action, line 2: 
socket] (curSocket).addresss = "127.0.0.1" 


Jeder Eintrag enthalt eine Fehlermeldung und die Fehlerposition. Um die fehlerhafte Zeile im Code anzuspringen, dop- 
pelklicken Sie auf die Fehlermeldung oder selektieren diese und driicken Return. REALbasic 6ffnet daraufhin den 
Code-Editor und zeigt den Fehler an. 


Abb. 264: Der erste Fehler aus dem Fehlerfenster im Code-Editor 


e808 Code Editor (Window1) 
> Eigenschaften 0 


Sub DataAvailable(Index As Integer) 

> @ Events listbox1.addrow "Socket " + str(index) + ":" + me.ReadAll 
> [) Menu-Kandler me.writen "Roger that, | got something from you" 

> B Methoden End Sub 

> Bi Notizen | 

¥ GSteuerelemente 

vy =f ListBox v4 

Change ’ 


Bae » 


Um Syntaxfehler zu vermeiden, k6nnen Sie wahrend des Codierens das Tippsfenster zu Rate ziehen und die Syntax fiir 


jedes Element tiberpriifen. Folgender Eintrag erscheint z.B. im Tippsfenster, wenn Sie der Folderltem-Klasse die SaveAs- 
Picture-Methode tibergeben: 


Q @ SaveAsPicture Image [,Format] 


Sie werden also darauf hingewiesen, dass die Methode das zu speichernde Bild und gegebenenfalls ein Format erwartet. 
Die méglichen Format-Codes finden Sie in der Sprachreferenz. 


Der Debugger und Breakpoints 


Im Debugger-Fenster k6nnen Sie Ihren Code Zeile fiir Zeile ausftihren und dabei die Werte der Variablen beobachten. 
Der Debugger markiert die Programmzeile, die als nachstes ausgeftihrt wird, mit einem griinen Pfeil am Zeilenanfang. 
Wenn der Debugger aktiv ist, werden alle Eintrage des Debug-Meniis aktiviert. 


Der Debugger und Breakpoints 
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Abb. 265: Das Debugger-Fenster 
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Stack 


Variablen 
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wr Nil 


(@ FileName Untitled e 
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Code Editor 


Breakpoints werden durch rote 
Punkte gekennzeichnet. 


v — 
Sub SaveFile(FileName as String,DisplaySaveDialog as Boolean) 
Dim f as Folderitem 
If Document=Nil or DisplaySaveDialog then 
#if TargetWin32 //if on Windows 
f=GetSaveFolderitem( "rtf" FileName) 
#else //not on Windows 


= al f=GetSaveFolderitem( "text" FileName) 
#endif 


Die nachste auszuftihrende 
Codezeile wird mit einem 
griinen Pfeil gekennzeichnet. 


@> If f<>Nil then //if the user clicked Save 
Title=f.Name //window title gets the document name 
Document=f //Document window property gets the folderitem for the document 
End if =4 


Das Debugger-Fenster ist in drei Bereiche unterteilt. Der Bereich des Code-Editors zeigt die Methode, die momentan 
ausgefiihrt wird. Die Ausfiihrung wurde in unserem Beispiel in der Zeile direkt unterhalb des Breakpoints ausgesetzt. 
Der rote Punkt markiert einen Breakpoint. Wenn der Debugger nach dem Starten des Programms zum ersten Mal 
erscheint, weil Sie einen Breakpoint gesetzt haben, befindet sich der griine Pfeil direkt am Breakpoint. 


Das Stack-Feld (aus dem engl.: ,,to stack“, dt. stapeln) enthalt die Namen der aktuellen Methode und aller Methoden, die 
zum Aufruf der aktuellen Methode gefiihrt haben. Sie werden in der Reihenfolge angezeigt, in der sie aufgerufen wur- 
den. Im Stack-Feld kénnen Sie also tiberpriifen, ob eine Methode auch tatsachlich dann aufgerufen wird, wenn Sie es 
wiinschen. Mit einem Klick auf die jeweilige Methode kénnen Sie deren Code einsehen. 


Abb. 266: Das Stack-Feld zeigt die Reihenfolge an, in der die Methoden aufgerufen werden 


TextWindow.SaveFile 
TextWindow.FileSaveAs_Action 


Das Variablen-Feld zeigt fiir die Methode, die gerade im Code-Editor dargestellt wird, eine Liste der lokalen Variablen 
samt deren Werte (falls vorhanden). Der Datentyp jeder Variablen wird mit einem kleinen Symbol angezeigt. 


Abb. 267: Das Variablenfenster 
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5 mydouble 
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Folderitem 
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Alle Objekte der Methode werden als Hyperlinks dargestellt. Beim Klick auf einen Hyperlink 6ffnet sich der 
,Object-Viewer*. Dieser enthilt eine Liste mit den aktuellen Werten der Eigenschaften des angeklickten Objekts. 
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Abb. 268: Der Object-Viewer 
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Der Vorteil von Object-Viewer und Variablen-Feld besteht in deren Interaktivitdét. Wahrend Sie im Debugger den Code 
Zeile fiir Zeile ausfiihren, werden in beiden Feldern die Werte in Echtzeit aktualisiert. Auf diese Weise konnen Sie heraus- 
finden, ob ein bestimmter Wert (oder vielleicht auch ein fehlender Wert) das Problem verursacht. 

Ein Object-Viewer ftir ein Fenster zeigt zwei Karteikarten an: Eigenschaften und Inhalt. Die Karteikarte Eigenschaften 
zeigt die aktuellen Werte der Eigenschaften des Fensters. Die Karteikarte Inhalt enthalt Hyperlinks auf die Steuerele- 
mente des Fensters. 

Anders als bei Fenstern haben die Object-Viewer der meisten anderen Steuerelemente nur die Karteikarte mit den 
Eigenschaften. 


Die Karteikarte ,,Eigenschaften” des Object-Viewers 


Die Eigenschaften-Karteikarte zeigt alle Eigenschaften eines Objekts und deren aktuelle Werte. Mit einem Schloss mar- 
kierte Eigenschaften k6nnen nur ausgelesen werden. Die anderen Eigenschaften konnen Sie im Object-Viewer bearbei- 
ten. Selektieren Sie dazu die entsprechende Zelle der Wertespalte. Andern Sie den Inhalt der Zelle und driicken Sie die 
Tab-Taste oder selektieren Sie eine andere Zelle, um die Anderung zu tibernehmen. 


e088 Fensterl [&hOEFCO18B] 


Name Wert 
FloaterProcess Qa 
GD Frame aod 7 
(FullScreen aFalse 
5 Graphics aGraphics [&hC7F8018E] 0 
(@B) Growicon aFalse 
OG Handle 43494288 
(@B} HasBackColor False 
Gd Height 4207 a 
GS Index (2 I 
OG Left adi . 
Le FA 


Auch Arrays kénnen im Debugger bearbeitet werden. In der Wertespalte wird dann ein Hyperlink angezeigt, der einen 
eigenen Dialog 6ffnet. In diesem Dialog konnen Sie die Elemente des Arrays bearbeiten. In der folgenden Abbildung 
handelt es sich bei der Eigenschaft ,Namen“ um ein Array mit drei Elementen. 


ionene) Fensterl [@h28FCO18B] 
; ; @ © AOStringo [&h38C8018C] 
Eigenschaften | Inhalt i el 
0 Lars e 
Name Wert 1 Dieter e 
5 Mousex a485 tT |2 Paul e 
0) MouseY 0347 . 
(@H Namen Strina(2) 3) 
WG pis Nil 


FM Diacamanr an x ————_ 


Der Debugger und Breakpoints 


355 


Enthilt eine Eigenschaft Text, wird dieser in der Wertespalte angezeigt. Falls dort nicht gentigend Platz zur Verfiigung 
steht, konnen Sie den kleinen Knopf am Zeilenende anklicken und damit den String-Viewer 6ffnen. Dieser zeigt nicht 


nur den vollstandigen Text, sondern auch dessen Codierung an. 


String(2) 


UTF-8 (— Abbrechen) @@quOKED 
| 


Bei Eigenschaften vom ‘yp ,,Picture“ zeigt der Object-Viewer die zwei Karteikarten ,Eigenschaften“ und , Inhalt“ an. 


Unter ,,Inhalt* kann man sich das Bild ansehen. 


@ © @ _ Startbild [«h358C018C] 
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Graphics aNil 
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ed 


Handelt es sich bei der Eigenschaft um ein Dictionary, besitzt der Object-Viewer ebenfalls zwei Karteikarten. Unter 
Inhalt werden die Schliissel-Wert-Paare angezeigt, die sich im Dictionary befinden. 


@ © @ Dictionary [&h3D5C018C] 


f Eigenschaften [inhale } 


Key 
Vorname 
Nachname 
Adresse 
Stadt 


Value 
Paul 
Maier 
Luisenstrasse 12 
Gladbach 


wNro 


Eigenschaften, die Objekte sind, werden als Hyperlinks angezeigt und 6ffnen jeweils einen Object-Viewer. Es k6nnen 


mehrere Object-Viewer gleichzeitig gedffnet sein. 


Die Karteikarte ,,Inhalt" des Object Viewers 


Die Karteikarte , Inhalt“ des Object-Viewers fiir ein Fenster zeigt die Steuerelemente an, die sich in dem Fenster befin- 
den. Die folgende Abbildung zeigt den Object-Viewer fiir PushButton1. 
@ © @ Fensterl [&h20FC018B] © © O PushButton1 [&h6B400182] 
Name Wert 
—— Eigenschaften [inhale } (BD Active aFalse i 
(BE) AutoDeactivate aTrue 
PushButton] [&h6B400182 palconele 5 ice e 
Listfiox1 [@hF0A80035] {OD Cancel aFalse 
PushBurton} [6hAFD40188] BH Caption aOriginal e 
EditField} (8hBC4C0188) Default False 
DisabledBalloonHe e 
(BI Enabled @True 
GS Handle 43536448 
GG Height a20 
HelpTag a e@ 
GG index 0 
(0 initialParent a 
@ ttalic aFalse 
GD Left a20 = 
| (@ LockBottom aFalse r 
- 
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Jede Verkniipfung 6ffnet einen Object-Viewer fiir das Objekt. Dies funktioniert bis zur letzten Ebene von Objekten. 


Wenn ein Fenster beispielsweise ein ImageWell-Objekt enthalt, wird dieses im Object-Viewer des Fensters als Hyperlink 
angezeigt. Enthalt das ImageWell-Objekt ein Bild, erscheint dieses im Object-Viewer des ImageWell-Objekts ebenfalls als 
Hyperlink. 


Die Werkzeugleiste des Debuggers 


Die Werkzeugleiste des Debuggers enthilt fiinf Knopfe, die einen direkten Zugriff auf Funktionen des Debug-Meniis 
gestatten. Mit den Kndpfen konnen Sie die Ausfitihrung Ihres Programms steuern. Es ist méglich, den Programmcode 
Zeile fiir Zeile auszuftihren. 


Abb. 269: Werkzeugleiste des Debuggers 


Programm fortsetzen 1 Funktion verlassen 


Nachste Zeile In Funktion springen 


Programm abbrechen 


Das Debug-Menii enthilt die gleichen Funktionen wie die Werkzeugleiste des Debuggers. 


Abb. 270: Das Debug-Menii bei aktivem Debugger 
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© Programm fortsetzen (in der IDE: Programm starten): Setzt die Ausfiihrung des Codes bis zum nachsten Break- 
point fort. Mit diesem Befehl verlassen Sie das Debugger-Fenster. 

© Programm abbrechen: Bricht die Ausfiihrung des Programmcodes ab und bringt Sie zuriick zur REALbasic 
Entwicklungsumgebung. 

@ Nachste Zeile: Fiihrt die aktuelle — mit einem griinen Pfeil markierte — Programmzeile aus. Springt zur nachsten 
Zeile. Wenn die aktuelle Zeile eine Methode beinhaltet, ftihrt der Debugger diese Methode auf einmal aus, arbeitet 
sie also nicht zeilenweise ab. 

© In Funktion springen: Fiihrt die aktuelle Zeile aus und springt auf die nachste. Falls die aktuelle Zeile einen Metho- 
denaufruf enthilt, zeigt der Debugger deren Code an und erlaubt es, diesen ebenfalls zeilenweise abzuarbeiten. 

e Funktion verlassen: Die aktuelle Methode wird bis zum Ende ausgefiihrt, ohne dass jede Zeile einzeln bestatigt 
werden muss. Das ist besonders dann sehr praktisch, wenn Sie vorher mit dem Befehl In Funktion springen in die 
Methode gesprungen sind und diese nun wieder verlassen wollen. 


Wann wird der Compiler-Lauf und die Programmausfihrung abgebrochen? 


Sie haben einen Syntaxfehler in Ihrem Code 


Wenn Sie ihr Projekt tiber Debug/Programm starten (38-R oder Strg-R) oder Datei/Applikation erzeugen ausfiihren 
oder tibersetzen méchten, priift REALbasic den Programmcode auf Syntaxfehler. Wird ein Fehler gefunden, so wird der 
Ubersetzungsvorgang abgebrochen und die Fehlerposition im Code-Editor gezeigt. 
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Sie haben einen Breakpoint gesetzt 


Sie konnen einen Breakpoint in eine Programmzeile setzen, bei deren Erreichen REALbasic das Programm anhalten und 
den Debugger 6ffnen soll. Die Zeilen, in die Sie einen Breakpoint setzen konnen, werden im Code-Editor mit einem Bin- 
destrich am Zeilenanfang markiert. Zum Setzen eines Breakpoints klicken Sie einfach auf den Bindestrich. 


Abb. 271: Setzen eines Breakpoints 


"eee Code Editor (Window1) 
> ivaines Sub Action() al l¢ 
> = Notizen 4, socket’ (curSocket).port = 2002 = 
¥ G@ Steverelemente socket 1 (curSocket).address = "127.0.0.1" 
Vv (B® ListBox1 socket] (curSocket).connect 
Vv @ PushButtonl curSocket = curSocket + 1 


= Action || End Sub 


=| Connected 
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Breakpoints werden als rote Punkte angezeigt und bleiben so lange erhalten, bis sie entfernt werden. Einen Breakpoint 
kGnnen Sie entfernen, indem Sie auf den roten Punkt klicken. Uber den Mentibefehl Debug/Alle Breakpoints léschen 
konnen Sie alle Breakpoints auf einmal entfernen. 


In einem Projekt gesetzte Breakpoints haben keine Auswirkungen auf mittels Ablage/Applikation erzeugen gene- 
rierte Stand-Alone-Anwendungen. 


Sie haben ctrl-C oder eine aquivalente Tastenkombination gedrickt 


Sie kénnen die Ausfiihrung eines mit Debug/Programm starten gestarteten Programms unterbrechen und den 
Debugger aufrufen, indem Sie die Tastenkombination ctrl-C (Windows ctrl-R oder F5) driicken. Dies ist besonders dann 
wichtig, wenn Sie entdecken, dass sich Ihr Programm in einer Endlosschleife befindet. 


Die Tastenkombination 3g-Shift-Punkt kann dazu nicht mehr verwendet werden. 


Alternativ gelangen Sie zur Entwicklungsumgebung zuriick, indem Sie ein Fenster der Entwicklungsumgebung 
anklicken. 


Die Ausfuhrung von Methoden verfolgen 


Wenn sich Ihr Programm nicht wie erwartet verhalt oder Sie nicht sicher sind, welche Methoden wann ausgefiihrt wer- 
den, kann es niitzlich sein, die Ausfiihrung jeder einzelnen Programmzeile zu beobachten. Der Debugger bietet Ihnen 
diese Moglichkeit. Wenn der Debugger aufgerufen wird, zeigt der griine Pfeil an, welche Zeile als nachstes ausgeftihrt 
wird. Jetzt haben Sie drei Méglichkeiten, das Programm schrittweise abzuarbeiten. 


Nachste Zeile 


Der Befehl Nachste Zeile fiihrt die aktuelle Zeile aus stoppt den Programmablauf in der nachsten Zeile. Wenn die aktu- 
elle Zeile den Aufruf einer Methode enthalt, fiihrt der Debugger diese Methode auf einmal aus, also nicht zeilenweise, 
und springt zur nachsten Zeile der aktuellen Methode. Nehmen Sie folgenden Code als Beispiel: 
EditFieldl.SelBold=True 

EditFieldl.Text=ToFrench(EditFieldl.Text) 

EditField.SelBold=False 

Nehmen wir an, dass die Methode ,/IoFrench* von Englisch nach Franzésisch tibersetzt. Wenn Sie den Code mit dem 
Befehl Nachste Zeile schrittweise abarbeiten, wird die zweite Zeile ausgefiihrt, ohne dass der Debugger den Code der 
Methode ,ToFrench* anzeigt. Er fiihrt ,/IoFrench* einfach aus und fahrt mit der nachsten Zeile fort. 
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In Funktion springen 


Der Befehl In Funktion springen fiihrt die aktuelle Zeile aus und springt in die nachste Zeile. Enthdlt die aktuelle Zeile 
allerdings den Aufruf einer Methode, verzweigt der Debugger in diese Methode und fiihrt deren Code zeilenweise aus. 
Wenn die Methode ausgefiihrt wurde, arbeitet der Debugger die aufrufende Methode weiter ab. 


Funktion verlassen 


Die aktuelle Methode wird bis zum Ende ausgefiihrt, ohne dass jede Zeile einzeln bestatigt werden muss. Das ist beson- 
ders dann sehr praktisch, wenn Sie vorher mit dem Befeh! In Funktion springen in die Methode gesprungen sind und 
diese nun wieder verlassen wollen. 


Die Ausfiihrung von Methoden mit dem Stack verfolgen 


Eine Methode oder ein Event-Handler kann eine andere Methode oder einen anderen Event-Handler aufrufen, der wie- 
derum weitere aufrufen kann. Da man dies beliebig fortftihren kann, braucht man eine Méglichkeit, die Reihenfolge zu 
protokollieren, in der die Methoden aufgerufen wurden. Das Stack-Feld leistet genau dies. Wenn Code ausgefiihrt wird 
(z.B. wenn ein PushButton angeklickt wird), zeigt das Stack-Feld den Event-Handler ,,Action“ des Buttons. Wenn der 
Event-Handler ,,Action“ eine Methode aufruft, wird diese Methode am Anfang der Stack-Liste eingefiigt. Wenn diese 
Methode eine weitere Methode aufruft, wird wiederum diese an den Anfang der Liste gesetzt. Wenn die aktuelle 
Methode beendet wurde, wird sie aus der Liste entfernt. Abbildung 266 zeigt das Stack-Feld mit einigen Methoden. 
Indem Sie eine auf dem Stack liegende Methode anklicken, kénnen Sie sich deren Quelltext im Code-Bereich des 
Debugger-Fensters anschauen. 

Beachten Sie: Je groer die Liste im Stack wird, desto mehr Speicher benotigt Ihr Programm. Falls Sie deshalb Probleme 
mit dem Speicherplatz bekommen sollten, miissen Sie versuchen, weniger Methoden-Aufrufe ineinander zu verschach- 
teln und weniger lokale Variablen zu verwenden. 


Beobachten von Variablen und Eigenschaften 


Im Debugger konnen Sie die Werte von Variablen, Objekten und Eigenschaften verfolgen, wahrend der Code ausgeftihrt 
wird. Dafiir gibt es das Variablen-Feld. Dieses Fenster zeigt lokale Variablen, Parameter, das aktuelle Objekt und dessen 
iibergeordnete Klasse an. Es zeigt auch globale Eigenschaften von Modulen und die Unterklasse, falls es eine gibt. 


Lokale Werte 


In Abbildung 272 wird gerade der ,,Action"-Event-Handler eines PushButtons ausgeftihrt. Die lokale Variable Self ver- 
weist auf das tibergeordnete Fenster. Me verweist auf das Objekt, dessen Code ausgefiihrt wird (in diesem Fall den Push- 
Button). Die Variablen f und m sind vom Typ Folderltem bzw. EditableMovie. 


Abb. 272: Das Variablen-Feld 
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Fiir Objekte zeigt die Wert“-Spalte ein Hyperlink. Mit einem Klick auf den Hyperlink 6ffnen Sie den Object-Viewer. Die- 
ser zeigt die aktuellen Werte fiir alle Eigenschaften des Objekts an. Sie konnen so viele Object-Viewer 6ffnen, wie Sie 
bendtigen. Object-Viewer kénnen geGffnet bleiben, wahrend Sie den Code abarbeiten, und werden automatisch aktuali- 
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siert, wenn sich eine Eigenschaft andert. Object-Viewer sind separate Fenster, deren Grofe Sie anpassen konnen, um 
auch lange Textzeilen, wie z.B. die AbsolutPath-Eigenschaft eines Folderltems, problemlos lesen zu konnen. 


Negative Zahlen werden im Object-Viewer in roter Schrift dargestellt. Hyperlinks sind blau und unterstrichen. 
Beachten Sie: Derzeit untersttitzt der Object-Viewer nur eindimensionale Arrays. 


Parameter 


Im Variablen-Feld werden auch die Parameter angezeigt, die an eine Methode iibergeben wurden. 


Globale Werte 


Am rechten Rand der Werkzeugleiste des Debugger-Fensters befinden sich zwei weitere Icons. 


Das erste gestattet den Zugriff auf Module. Besteht Ihr Projekt aus zwei oder mehr Modulen, werden diese in einem 
Popup-Menii aufgelistet, sobald Sie auf das Modulsymbol klicken. Damit haben Sie Zugriff auf geschtitzte Eigenschaften 
des Moduls. 


Das zweite Symbol ermoglicht den Zugriff auf globale Variablen (ungeschiitzte Eigenschaften von Modulen). 


Objekt-IDs 


Der Debugger kann die vom Compiler verwendeten Objekt-IDs anzeigen. Diese sind allerdings zum Debuggen eines 
REALbasic-Projekts nicht notig. Deshalb werden sie per Voreinstellung nicht angezeigt. In den REALbasic-Einstellungen 
konnen Sie unter ,Debugger“ die Option ,,Zeige Objekt-IDs in der Variablen-Liste“ aktivieren. 


0860 REALbasic IDE Voreinstellungen 
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Im Variablen-Feld des Debuggers wird dann die ID eines Objekts in eckigen Klammern hinter dessen Typ oder Klasse 
angezeigt. In der Abbildung sehen Sie eine solche ID fiir die Eigenschaft ,,Graphics*. 


e0e8 Fensterl [&hOEFCO18B] 


Name Wert 
8 FloaterProcess er 
G5 Frame aod 
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360 Debugging Ihres Codes 


Starten und Stoppen des Projekts 


Wenn Sie Ihr Programm aus der REALbasic-Entwicklungsumgebung mittels Debug/Programm starten gestartet haben, 
konnen Sie die Programmabarbeitung jederzeit anhalten und in die Entwicklungsumgebung wechseln, indem Sie auf ein 
Fenster der Entwicklungsumgebung klicken. 

Soll die Programmabarbeitung fortgesetzt werden, wahlen Sie erneut den Mentipunkt Debug/Programm starten (8-R 
bzw. Strg-R). Soll das Programm nicht fortgesetzt werden, rufen Sie den Mentipunkt Debug/Kill (38-K bzw. Strg-K) auf. 


Runtime Exception Fehler 


Laufzeitfehler in der Runtime-Umgebung der Entwicklungsumgebung 


Im Gegensatz zu Syntaxfehlern, die REALbasic bereits wahrend des Compilierens entdecken kann, treten Laufzeitfehler 
erst wahrend der Ausfiihrung eines Programms auf. Es ist also méglich, syntaktisch korrekten Programmcode zu schrei- 
ben, der beim Ausftihren des Programms zu einem Fehler fihrt. 


Wenn Sie Ihr Projekt mit Debug/Programm starten aus der Entwicklungsumgebung starten und wahrend der Pro- 
grammabarbeitung ein Laufzeitfehler auftritt, wird das Programm abgebrochen und die Fehlerposition im Code-Editor 
markiert. 

Um Laufzeitfehler mit dem Debugger aufzuspiiren, sollten Sie Debug/Break bei Exceptions aktivieren. Dann meldet 
sich der Debugger, wenn ein Laufzeitfehler auftritt, und gibt Ihnen die Méglichkeit, nach der Fehlerursache zu suchen. 


Abb. 273: Ein Runtime Exception Fehler im Debugger 


"eee Debugger 
siwiletfathe% - 
[&| [x] |e a| {| wié 
Fenster1.ListBoxl_Open Variablen Wert 
UG self Fensterl 
me ListBox1 
wi 167 
Gd nFonts 167 
v 
Sub Open() 


Dim i, nFonts as Integer 
nFonts=FontCount 
For i=1 to nFonts //Tun Sie das nicht! 
ListBox1 .addrow(font(i)) 
OutOfBoundsException (Hilfe) | 
<< 


End Sub 


Laufzeitfehler in der fertigen Anwendung 


Wenn der Fehler in einer Stand-Alone-Applikation auftritt, erscheint eine Fehlermeldung, die den Typ des aufgetretenen 
Problems beschreibt. Hier ein Beispiel: 


Abb. 274: Ein nicht abgefangener Runtime Exception Fehler in einer Stand-Alone-Applikation 


Eine Exception der Klasse OutOfBoundsException ist 


ts nicht vorgesehen. 
“= 


Das Programm muss abgebrochen werden. 


Goes 


Die Applikation wird beendet, sobald der Anwender die Fehlermeldung bestiatigt. 
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Laufzeitfehler abfangen 


REALbasic kann Laufzeitfehler erkennen und abfangen. Es gibt mehrere sogenannte Runtime Exceptions, die Sie in 
Threm Code erkennen und abfangen konnen, um zu verhindern, dass das Programm abstiirzt. Diese Runtime Exceptions 
sind in folgender Tabelle aufgefiihrt: 


Tabelle 42. Runtime Exception Fehler in REALbasic 


Name Beschreibung Beispiel 

IllegalCastException Sie haben ein Objekt auf eine Einen BevelButton als PushButton verwenden: 
andere Klasse ,,gecastet” und Dim c as Control 
ihm eine Nachricht geschickt, die c=New BevelButton] 
seine tatsachliche Klasse nicht PushButton(c).Push 
verarbeiten kann. 

InvalidParentException Sie haben versucht, tiber die Dem Code selbst sieht man nichts an, nur die 
Parent-Eigenschaft der Benutzeroberflache ware fehlerhaft. 


Control-Klasse auf den Elternteil 
(Parent) eines Steuerelements 
zuzugreifen. Das Steuerelement 
befindet sich jedoch in einem 
anderen Fenster. 


KeyNotFoundException Sie haben versucht, auf einen Der Zahler nimmt einen Wert an, den es im Dictionary 
Schlussel zuzugreifen, der nicht nicht gibt. 
Bestandteil eines For i=l to d.Count 
Dictionary-Objekts ist. ListBoxl.Addrow d.value(i) 
Next 
KeyChainException Eine Methode der KeyChain- oder Sie haben versucht, mehr als ein KeyChain-Element fiir 


KeyChainltem-Klasse konnte nicht dieselbe Applikation anzulegen. 
ausgefihrt werden. 


NilObjectException Es wurde versucht, auf ein nicht Zugriff auf ein Nil-FolderItem: 
existierendes Objekt zuzugreifen. Dim f as FolderItem 
f.Delete 
OLEException Ein in Zusammenhang mit OLE 
stehender Laufzeitfehler ist 


aufgetreten. 
OutOfBoundsException Es wurde versucht, einen Wert Zugriff auf ein Array-Element, das nicht existiert: 


auszulesen oder zu schreiben, der Dim a(3) as String 
auBerhalb der Grenzen des a(4)="Hugo” 
Objekts oder des Datentyps liegt. 
OutOfMemoryException Eine Aufgabe konnte nicht GroBe Bitmaps belegen sehr viel Speicher. 
ausgefihrt werden, da nicht 


usreichend Speicher zur 
Verfiigung stand. 


RbScriptAlreadyRunning Der Benutzer hat versucht, ein Vermeiden Sie dies! 


fed) 


Exception laufendes Script oder dessen 
Kontext-Objekt zu andern. 
RegExException Sie haben ein ungiltiges Fehlende ,,]" am Ende eines regularen Ausdrucks: 


Suchmuster in einem regularen = Laeiou 
Ausdruck verwendet. 
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Name Beschreibung Beispiel 
RegistryAccessError Sie haben auf die Registrier— 
Exception datenbank zugegriffen, ohne eine 


entsprechende Erlaubnis des 
Betriebssytems zu haben. 


ShellNotRunning Sie haben versucht, auf eine Uberpriifen Sie die IsRunning-Eigenschaft des 
Exception interaktive Shell zuzugreifen, Shell-Klasse-Objekts, bevor Sie darauf zugreifen. 
nicht gestartet war. 
StackOverflowException Wenn Ihrer Applikation der Aufruf einer rekursiven Methode, bis der Stack Uberlauft: 
Stack-Speicher ausgeht, tritt eine Sub Square (i as Integer) as Integer 
StackOverflowException auf. Return Square(i) 
End Sub 


Die Aufruf-Routine: 
Dim i as Integer 
i=Square(2) 
TypeMismatchException Sie haben versucht, einem Objekt Sie versuchen einer Integer-Variablen einen Variant 
den falschen Datentyp zuzuweisen, dem urspringlich ein Bild zugewiesen wurde 
zuzuweisen. (das ins Projektfenster gezogen wurde). 
Dim v as Variant 
Dim i as Integer 


v=REALI ogo 
i=v 
UnsupportedFormat Sie verwenden einen Sie ibergeben einen String an die 
Exception String-Audruck, der keine Zahl ColumnWidth-Eigenschaft einer ListBox, der keine Pixel- 


ergibt, in einem Kontext, indem oder Prozentzahl ergibt. 
das Ergebnis eine Zahl sein muss. ListBoxl.ColumnWidths="50,50a” 
Eine Beschreibung jedes Fehlertyps samt Beispielen finden Sie in der Sprachreferenz. 


Sie k6nnen mit einem Exception Block Laufzeitfehler abfangen und auf diese reagieren (z.B. informativere Warnboxen 
anzeigen) und verhindern, dass die Applikation abstiirzt. Exception Blocks stehen im Programmcode immer am Ende 
einer Methode, da jede dem Exception-Schliisselwort folgende Zeile als Teil des Exception Blocks angesehen wird. 


Wenn ein Exception Block einen Laufzeitfehler abfingt, wird der Code im Exception Block ausgeftihrt und erlaubt Ihnen, 
Informationen tiber die Problemstelle und die Werte, die den Fehler ausgeldst haben, anzuzeigen. 


Ein Exception Block erméglicht es Ihnen, individuell auf Fehler zu reagieren. Damit haben Sie mehr Kontrolle dariiber, 
wie mit einem Fehler umgegangen wird, als bei Aktivieren des Break bei Exceptions-Mentipunkts. 


Die Exception-Anweisung erscheint im Code-Editor mit der gleichen Einrtickung wie die Sub- oder Function-Zeile. 
Sie konnen ,,Exception“ ohne Parameter verwenden, wenn Sie auf alle Laufzeitfehler identisch reagieren wollen: 
Sub... 


Exception 
MsgBox "Irgendwas Schlimmes ist passiert, ich weiB aber nicht, was." 
End Sub 


Die Syntax eines Exception Blocks lautet: 
Exception errorParameter As errorType 
errorParameter und errorlype sind optional, errorType kann nicht ohne errorParameter verwendet werden. 
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Das oben gezeigte Beispiel bewahrt das Programm zwar vor einem Absturz, die Fehlermeldung sagt aber nichts tiber die 
aufgetretene Exception aus. 


Mit einem If-Befehl im Exception Block kénnen Sie errorParameier testen: 
Sub... 


Exception err 
If err IsA TypeMismatchException then 
MsgBox "Sie haben versucht, den Typ eines Objekts zu dndern!" 
elseif err IsA NilObjectException then 
MsgBox "Sie haben versucht, auf ein Nil-Objekt zuzugreifen!" 
End if 
End Sub 


Der OutOfBoundsException-Laufzeitfehler kann folgendermafsen abgefangen werden: 


Sub Action() 
Dim i, nFonts as Integer 
nFonts=FontCount 
for i=l to nFonts 
listBoxl.addrow(Font(4)) 
next 
Exception err 
if err IsA OutOfBoundsException then 
msgBox "Fehler beim Laden der Font-Namen ins Font-Menti!" 
end if 
End Sub 


Wird dieser Code ausgefiihrt, erscheint folgende Dialogbox.: 


Fehler beim Laden der Font-Namen ins Font-Meniti! 


Wenn der Anwender diese Warnbox bestitigt, wird das Programm nicht beendet. 


Statt mehrfacher If-Anweisungen konnen Sie auch mehrere Exception Blocks verwenden, wobei jeder auf einen anderen 
Exception-Typ reagieren kann. 
Sub... 


Exception err as TypeMismatchException 

MsgBox "Sie haben versucht, den Type eines Objekts zu dndern!" 
Exception err as NilObjectException 

MsgBox "Sie haben versucht, auf ein Nil-Objekt zuzugreifen!" 
End Sub 
Falls die Methode, in der ein Laufzeitfehler auftritt, bzw. deren aufrufende Methode keinen Exception Block besitzt, 
haben Sie eine letzte Chance, Laufzeitfehler abzufangen, bevor diese die Anwendung zum Absturz bringen. Dazu gibt es 
den UnhandledException-Event der Application-Klasse. Dieser Event wird ausgelést, wenn irgendwo in der Anwendung 
ein Laufzeitfehler auftritt, der nicht von einem Exception Block abgefangen wurde. Der UnhandledException-Event 
erhalt einen Parameter des Typs RuntimeException. So kénnen Sie eine Funktion schreiben, die sich um die Exception 
kiimmert. Aus Sicherheitsgriinden k6nnten Sie eine allgemeine Routine schreiben, die alle in Tabelle 42 aufgefiihrten 
RuntimeExceptions abfangt. 
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Folgender Programmcode im UnhandledException-Handler des App-Objekts fangt alle Laufzeitfehler des Typs OutOf- 
BoundsException ab: 


Function UnhandledException(error as RuntimeException) as Boolean 
If error IsA OutOfBoundsException then 
MsgBox "Ein OutOfBounds Exception Fehler ist aufgetreten!" 
End if 
Return True 
End Function 


Diese Art, Laufzeitfehler abzufangen, liefert keinen eindeutigen Hinweis auf die genaue Fehlerursache, da alle 
OutOfBoundsExceptions der Anwendung abgefangen werden. 


Remote Debugging 


Mit Remote Debugging (,,ferngesteuertem Debuggen“) konnen Sie Ihr Projekt unter einem anderen Betriebssystem auf 
einem anderen Computer testen. Wenn Sie beispielsweise Ihre Applikation unter Mac OS X entwickeln und sie unter 
Windows testen wollen, wird eine Debug-Version der Applikation tiber das Netzwerk auf den Zielrechner geschickt und 
dort automatisch gestartet. 


Remote Debugging ist nur in der Professional-Version von REALbasic verftigbar. 


In den folgenden Ausfiihrungen heifst der Computer, auf dem REALbasic lauft, ,Entwicklermaschine“ und der Computer, 
auf dem die Applikation getestet wird, ,Testmaschine’. 


Remote Debugging benotigt ein Hilfsprogramm, das auf der Testmaschine gestartet werden muss. Dieses Programm 
heift ,,Remote Debugger Stub“ und muss zunachst auf der Testmaschine installiert und konfiguriert werden. Danach 
k6nnen Sie auf der Entwicklermaschine das Remote Debugging tiber Debug/Starte Remote-Debugging starten. 


Um Remote Debugger Stub zu konfigurieren, fiihren Sie folgende Schritte aus: 
1. Kopieren Sie Remote Debugger Stub auf die Testmaschine und starten Sie es mit einem Doppelklick. 
Das Hauptfenster erscheint, in dem der Name und die IP-Adresse leer sind. 
2. Wahlen Sie Edit/Options (Windows und Linux) oder Remote Debugger Stub/Preferences (Macintosh): 


°0e08 REALbasic Remote Debugging Stub 


Machine Name: ‘Hier Rechnername eintragen| } 


Listening Port: 33445 


ww Public Debugger Stub () Log Access Information 


Hier miissen folgende Einstellungen vorgenommen werden: 


Machine Name: Name des Testrechners. Er wird auf der Entwicklermaschine angezeigt und dient zur Identifikation 
des Testrechners. Er ist frei wahlbar. 


Listening Port: Port, auf dem Remote Debugger Stub TCP-Verbindungen annimmt. Der vorgegebene Port funktio- 
niert fiir die meisten Anwendungsfille. Die Option ist speziell dann interessant, wenn im Netzwerk eine Firewall 
verwendet wird. 

Public Debugger Stub: Falls aktiviert, kann jeder im lokalen Netzwerk feststellen, dass auf dieser Maschine ein 
REALbasic Debugger Stub lduft. Aktivieren Sie die Option, damit Sie auf dieser Maschine debuggen kénnen. 

Log Access Information: Ist diese Option aktiviert, werden alle Zugriffe auf die Maschine protokolliert. Damit k6n- 
nen Sie sehen, wann und von welcher IP-Adresse aus der Debugger benutzt. Das Protokoll wird in dem Verzeichnis 
abgelegt, in dem sich das Programm Remote Debugger Stub befindet. 
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3. Klicken Sie OK und sichern Sie die Einstellungen. 

Wiederholen Sie die Schritte fiir jede weitere Testmaschine. 

Als nachstes miissen Sie die Entwicklermaschine ftir Remote Debugging konfigurieren. 

1. Wahlen Sie den Mentipunkt Debug/Starte Remote-Debugging/Konfiguration... Es ffnet sich die Dialogseite 
»Debugger“ des REALbasic-Einstellungen-Dialogs. 
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‘a 4 Debugger 


Li) w Zeige Objekt-IDs in der Variablen-Liste. 
Tipps-Fenster 


a Remote-Debugger-Verbindungen 


Computername Adresse 


Erzeugen-Proze& 


= 


Drucken 


® 


Pel gge 7  ( Hinzufigen ) Bearbeiten Entfernen 
Rovrecen) XD 


Unter Remote-Debugger-Verbindungen kGnnen Sie verfiigbare Testmaschinen eintragen. 


2. Klicken Sie auf ,,Hinzuftigen“, um eine neue Testmaschine einzutragen. Es erscheint eine Liste aller Rechner im Netz- 
werk, auf denen zu diesem Zeitpunkt ein Remote Debugger Stub lauft. 
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Automatisch gefundene Debug-Hosts: 


Computername Adresse 
Mac OS X 10.3.4 192.168.1.216 
Windows XP 192.168.1.43 


Adresse: 


(Suchen) ( Abbrechen ) (550K) 4 


Der Computername in der ersten Spalte entspricht jeweils dem ,Machine Name“, den Sie in den Einstellungen des 
Remote Debugger Stubs vergeben haben. 

3. Wahlen Sie eine Testmaschine aus. Der Name und die IP-Adresse der Testmaschine werden in die entsprechenden 
Felder eingetragen. Hier k6nnen Sie auch manuell eine Testmaschine eintragen. 

4. Klicken Sie OK. Damit iibernehmen Sie den Computer in die Liste der Testmaschinen. 


5. Wiederholen Sie diese Schritte fiir alle weiteren Testmaschinen. 
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Die Testmaschinen erscheinen unter Debug/Starte Remote-Debugging im Menii: 


f Debug | Fenster Extras Help 


«> Programm starten #R 
Starte Remote-Debugging > Mac OS X 10.3.4 aR 
X Progr bb r 
Windows XP 
ds } 
ry) } ; ; 
Konfiguration... 
@ 4 


V—_—_—_———_—_ 
® Bre soin cher 

& Alle Breakpoints loschen 

¥ $! Break bei Exceptions 

——————————————— 


Die zuletzt benutzte Testmaschine erscheint ganz oben und ist auch tiber einen Tastatur-Shortcut erreichbar. 
Um das aktuelle Projekt auf einer Testmaschine zu debuggen, gehen Sie folgendermafen vor: 

1. Vergewissern Sie sich, dass Remote Debugger Stub auf der Testmaschine gestartet wurde. 

2. Wahlen Sie die gewiinschte Testmaschine aus dem Starte Remote-Debugging-Untermenii. 


Daraufhin erzeugt REALbasic eine Debug-Version Ihrer Applikation und schickt diese tiber das Netzwerk auf die Test- 
maschine, wo sie automatisch gestartet wird. Ein Fortschrittsbalken zeigt den Verlauf an. 


3. Jetzt konnen Sie an der Testmaschine Ihre Applikation testen. 
Falls Sie Breakpoints gesetzt oder den Debugger aktiviert haben, erscheint dieser auf der Entwicklermaschine. 


Sie miissen die Debug-Version Ihres Programms beenden, bevor Sie in der Entwicklungsumgebung weiter arbeiten 
konnen. Beenden Sie dazu entweder das Programm auf der Testmaschine oder rufen Sie auf der Entwicklermaschine 
den Mentipunkt Debug/Programm abbrechen auf. 


Uber Firewalls 


Damit Remote Debugging funktionieren kann, miissen bestimmte Ports Ihrer Firewall freigeschaltet sein. Fiir die 
UDP-Ports 44553 und 44554 sowie den TCP-Port 13897 muss ein- und ausgehender Verkehr erlaubt sein. 


Den TCP-Port kGnnen Sie andern, die UDP-Ports nicht. 
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Manche Anwendungen miissen mit anderen Computern kommunizieren oder auf Hardware zugreifen, die am seriellen 
Port angeschlossen ist. 


Soll zum Beispiel eine Internet-Verbindung hergestellt werden, dann muss eine Verbindung zwischen einem Programm 
auf Ihrem Computer und dem Programm, das auf dem Computer lhres Internet-Providers lauft, hergestellt werden. 


REALbasic enthalt Steuerelemente, die die Kommunikation von Programmen auf verschiedenen Rechnern und die Kom- 
munikation tiber die serielle Schnittstelle stark vereinfachen. 


Inhalt 


© Kommunikation mit seriellen Geraten 
@ Kommunikation mit anderen Rechnern tiber TCP/IP 
@ Kommunikation mit anderen Rechnern tiber UDP 


Kommunikation mit seriellen Geraten 


Ein serielles Gerat kann serielle Datenstréme empfangen oder senden, nicht beides gleichzeitig. Das gebrauchlichste 
serielle Gerit ist ein Modem. Auch manche Drucker werden seriell angeschlossen. Um mit solchen Geraten zu kommu- 
nizieren, verwendet man in REALbasic das Serial-Steuerelement. 


Konfiguration des Serial-Steuerelements 


Der erste Schritt besteht darin, ein Serial-Steuerelement auf einem Fenster abzulegen oder mittels Programmcode eine 
Instanz eines Serial-Steuerelements zu erzeugen. Vor der Kommunikation muss man das Serial-Steuerelement konfigu- 
rieren. Dies ist tiber das Eigenschaftenfenster schon wahrend des Programmentwurfs méglich. 


Einige Geradte k6nnen nur mit einer einzigen Einstellung betrieben werden — andere, wie beispielsweise Modems, k6n- 
nen mit einer Vielzahl von Parametern benutzt werden. Hier spielt auch eine Rolle, wie das entfernte Modem, mit dem 
man eine Verbindung aufnimmt, konfiguriert ist. Die Voreinstellung des Serial-Steuerelements sollte mit den meisten 
Modems funktionieren. 


Offnen des seriellen Ports 


Nach der Konfiguration des Steuerelements k6nnen Sie den Port 6ffnen, um die Kommunikation mit dem Gert zu star- 
ten. Dazu rufen Sie die Open-Methode des Serial-Steuerelements auf. Diese Methode ist eine Funktion, die True zurtick- 
liefert, wenn die Verbindung geoffnet wurde und False, wenn etwas schiefgegangen ist. Das Beispiel zeigt, wie mit einem 
Steuerelement namens Serial1 ein Port ge6ffnet wird: 
If Seriall.Open then 

MsgBox "Der Port wurde gedffnet." 
Else 

MsgBox "Der Port wurde nicht gedffnet." 
End if 
Nachdem der Port gedffnet wurde, ist er fiir andere Anwendungen und sogar fiir andere Serial-Steuerelemente gesperrt, 
bis Sie ihn wieder schlie&en. 
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Daten lesen 


Der DataAvailable-Event-Handler des Serial-Steuerelements wird ausgeldst, sobald Daten des seriellen Gerats empfan- 
gen werden. Die Daten werden in einem Speicherbereich abgelegt, den man Puffer (Buffer) nennt. 


Im DataAvailable-Event-Handler lesen Sie die Puffer-Daten mit den Methoden Read oder ReadAll aus. Beide Methoden 
sind Funktionen. Mit Read lesen Sie eine bestimmte Anzahl von Bytes (Zeichen) aus dem Puffer und mit ReadAll lesen 
Sie den gesamten Pufferinhalt. Nach dem Lesen werden die Daten automatisch aus dem Puffer entfernt, um Platz fiir 
weitere ankommende Daten zu schaffen. Sollte es erforderlich sein, auf die Daten zuzugreifen, ohne den Pufferinhalt zu 
loschen, k6nnen Sie die LookAhead-Eigenschaft des Serial-Steuerelements verwenden. 


So werden eingehende Daten an ein EditField angehangt: 


Sub DataAvailable() 
EditFieldl.Text=EditField1l.Text+Me.ReadAll() 
End Sub 


Wenn Sie die Daten im Puffer einfach nur entfernen mGchten, ohne sie zu lesen, rufen Sie die Flush-Methode auf. 


Daten schreiben 


Sie konnen Daten zu einem seriellen Port schicken, wenn dieser erfolgreich gedffnet wurde. Dazu verwenden Sie die 
Write-Methode des Serial-Steuerelements. Der Write-Methode tibergeben Sie eine Zeichenkette (String), die die Daten 
enthalt. 


Die Write-Methode arbeitet asynchron. Die nachste Write-Anweisung kann also bereits ausgefiihrt werden, bevor alle 
Daten des vorherigen Write tatsichlich tibertragen wurden. Sollten Sie aus irgendeinem Grund warten wollen, bis die 
zuvor geschickten Daten versendet wurden, k6nnen Sie direkt nach dem Write die XmitWait-Methode aufrufen. 


Dynamisches Andern der Konfiguration 


Manchmal muss die Konfiguration des Serial-Steuerelements verandert werden, wahrend der Port ge6ffnet ist. Sie kon- 
nen die Eigenschaften zwar verandern, aber die Konfiguration des Ports dndert sich erst dann, wenn der Port geschlos- 
sen und erneut ge6ffnet wird. Sollen die Anderungen sofort wirksam werden, rufen Sie die Poll-Methode des 
Serial-Steuerelements auf. Diese Methode verandert die Einstellungen sofort und ruft den DataAvailable-Event-Handler 
auf, falls noch Daten im Puffer stehen, die gelesen werden miissen. 


SchlieBen des Ports 


Ist die Kommunikation mit dem seriellen Gerat beendet, miissen Sie den Port wieder schliefSen, um ihn ftir andere 
Anwendungen verftigbar zu machen. Dazu rufen Sie die Close-Methode des Serial-Steuerelements auf. 
Kommunikation mit Modems 


Ein Modem hat einen Befehlssatz, der z.B. einen Befehl zur Anwahl einer bestimmten Rufnummer enthalt. Die meisten 
Modems verwenden den AT-Befehlssatz. Im Handbuch Ihres Modems sollte der verwendete Befehlssatz dokumentiert 
sein. 


Kommunikation mit USB- und FireWire-Geraten 


USB- und FireWire-Gerate bendtigen spezielle Treiber. Wenn Sie ein solches Gerat ansteuern wollen, bendtigen Sie eine 
Shared Library des Gerdteherstellers oder mitissen sich diese selbst schreiben. 


Kommunikation tiber TCP/IP mit TCPSocket 369 


Kommunikation Uber TCP/IP mit TCPSocket 


Mit dem TCPSocket-Steuerelement kénnen Sie eine TCP/P-Verbindung innerhalb eines Netzwerks aufbauen, um mit 
anderen Computern zu kommunizieren. 


In den Versionen vor REALbasic 5.0 wurde zur Kommunikation tiber TCP/IP das Socket-Steuerelement verwendet. Dieses 
wurde durch das TCPSocket-Steuerelement ersetzt. 


Das TCPSocket-Steuerelement leitet sich von einer neuen Basis-Klasse ab, der SocketCore-Klasse. Die SocketCore-Klasse 
kiimmert sich um die Grundfunktionen der Protokolle TCP und UDP. Die SocketCore-Klasse ist eine abstrakte Klasse, 
die nicht instanziiert werden kann und besitzt Eigenschaften und Methoden, die von den Steuerelementen TCPSocket, 
ServerSocket und UDPSocket genutzt werden. Wenn Sie das alte Socket-Steuerelement noch in Ihren Projekten verwen- 
den, sollten Sie es durch TCPSocket ersetzen. 


TCP/IP ist das Protokoll, das auch im Internet verwendet wird. TCP steht ftir Transmission Control Protocol, IP steht fiir 
Internet Protocol. 


Wenn Sie eine Verbindung zum Internet herstellen, wird Ihr Computer Teil des Internets und kommuniziert mit anderen 
Computern tiber TCP/IP. 


Konfiguration 


Vor der Kommunikation mit einem TCPSocket-Steuerelement steht die Konfiguration. Die Kommunikation erfolgt auch 
bei TCP/IP tiber einen Port, nur dass es sich dabei nicht um eine Hardware-Schnittstelle Ihres Computers handelt. TCP/ 
IP-Ports sind so etwas ahnliches wie Fernsehkanile. Allerdings gibt es tausende Ports. Sie konnen sich ganz darauf kon- 
zentrieren, Daten an die Ports zu schicken und Daten aus den Ports auszulesen und miissen sich nicht mit den Details 
des TCP/IP-Protokolls herumschlagen. Da fiir E-Mail und WWW unterschiedliche Ports verwendet werden ist es méglich, 
gleichzeitig im Web zu browsen und E-Mails zu versenden. Jeder Port wird durch eine Nummer reprasentiert. Wenn Sie 
mit einer anderen Anwendung tiber TCP/IP kommunizieren wollen, miissen Sie wissen, welche Portnummer diese 
Anwendung verwendet. Ist die andere Anwendung z.B. ein SMTP-Server (Simple Mail Transfer Protocol), dann verwen- 
det sie wahrscheinlich Port 25, da dieser ftir SMTP vorgesehen ist. 


Ein TCPSocket-Steuerelement hat eine Port-Eigenschaft (abgeleitet von der SocketCore Klasse), die bereits wahrend des 
Programmentwurfs oder spater wahrend des Programmlaufs gesetzt werden kann. Sie muss aber auf jeden Fall gesetzt 
sein, um eine Verbindung aufzubauen. Aufserdem miissen Sie die IP-Adresse des Computers kennen, zu dem Sie eine 
Verbindung aufbauen wollen. Diese wird in der Address-Eigenschaft des TCPSocket-Steuerelements abgelegt. 


Mac OS X und Linux schrinken die freie Verwendung von Portnummern ein. Ports unterhalb von 1024 kénnen nur von 
einem Benutzer mit ,,root“-Zugriffsrechten verwendet werden. Mac OS X ist so angelegt, dass ein Benutzer tiber die gra- 
fische Benutzeroberfliche keine ,,root‘-Privilegien erlangen kann. Die meisten Anwender haben ,,Admin‘“-Zugriffsrechte. 
Dies ist kein Fehler, sondern eine Sicherheitsvorkehrung. Da TCPSocket nicht auf Portnummern kleiner als 1024 zugrei- 
fen kann, sollten Sie fiir die normale TCP/IP-Kommunikation mit Mac OS X-Computern nur Ports ab 1024 verwenden. 
Anmerkung: Ein TCPSocket-Steuerelement kann nur eine Verbindung gleichzeitig herstellen. Wenn Sie mehrere Verbin- 
dungen aufbauen méchten, sollten Sie das ServerSocket-Steuerelement verwenden. Es ist speziell daftir ausgelegt. 
Detaillierte Informationen zu diesem Thema finden Sie im Abschnitt , Mit ServerSocket mehrere Verbindungen gleichzei- 
tig verwalten“ auf Seite 373. 


Mit einem anderen Computer verbinden 


Sind Port und Adresse definiert, konnen Sie die Verbindung zu einer Anwendung auf einem anderen Computer herstel- 
len, sofern diese auf dem Port, den Sie angegeben haben, auf eine Verbindung wartet. Sie stellen die Verbindung mit der 
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Connect-Methode des TCPSocket-Steuerelements her. Es ist nicht sichergestellt, dass die Verbindung sofort zustande 
kommt. Aufgrund netzwerktechnischer Gegebenheiten kann es zu Verzogerungen beim Verbindungsaufbau kommen. 


Es gibt zwei Méglichkeiten festzustellen, ob eine Verbindung aufgebaut wurde. Entweder Sie warten, bis der 
Connected-Event ausgelést wird oder Sie priifen den Riickgabewert der IsConnected-Methode der SocketCore-Klasse. 
Wenn Sie nicht auf die Bestatigung warten, kann es passieren, dass der Verbindungsaufbau abbricht und ein Verbindung 
verloren‘-Fehler (102) oder ein ,Unbekannter Zustand“-Fehler (106) auftritt. 


Ist die Verbindung aufgebaut, wird der Connected-Event-Handler ausgefiihrt. Konnte die Verbindung nicht aufgebaut 
werden oder ist ein Fehler aufgetreten, wird der Error-Event-Handler ausgeftihrt. 


Wurde die Verbindung erfolgreich aufgebaut, kann Ihre Applikation Daten verschicken oder empfangen. 


Auf eine Verbindung warten 


Es gibt auch die Méglichkeit, dass Ihre Anwendung darauf warten soll, dass ein anderer Computer zu ihr Kontakt auf- 
nimmt. Das heifst, dass Sie die Verbindung nicht aktiv aufbauen, sondern darauf warten, dass ein anderer Computer 
Anschluss sucht. Rufen Sie dazu die Listen-Methode des TCPSocket-Steuerelements auf. Wenn Sie beispielsweise ein 
TCPSocket-Steuerelement namens TCPSocket1 verwenden, das nach Betitigen eines Knopfes auf eine Verbindung war- 
ten soll, dann schreiben Sie folgenden Code: 

Sub Action() 


TCPSocket1.Listen 
End Sub 


Steht die Verbindung, wird der Connected-Event-Handler des TCPSocket-Steuerelements ausgeftihrt. 


Daten lesen 


Schickt die Anwendung am anderen Ende der Verbindung Daten, wird der DataAvailable-Event-Handler des TCP- 
Socket-Steuerelements aufgerufen. Auch hier werden die Daten zundchst in einem Puffer (Buffer) abgelegt. 


Im DataAvailable-Event-Handler k6nnen Sie mit den Read- und ReadAll-Methoden des TCPSocket-Steuerelements die 
Daten aus dem Puffer auslesen. Mit Read lesen Sie eine bestimmte Anzahl von Bytes (Zeichen) aus dem Puffer und mit 
ReadaAll lesen Sie den gesamten Pufferinhalt. Nach dem Lesen werden die Daten automatisch aus dem Puffer entfernt, 
um Platz fiir weitere ankommende Daten zu schaffen. Sollte es erforderlich sein, auf die Daten zuzugreifen, ohne sie aus 
dem Puffer zu entfernen, kénnen Sie die LookAhead-Eigenschaft des TCPSocket-Steuerelements dazu verwenden. 


So werden eingehende Daten an ein EditField angehangt: 


Sub DataAvailable() 

EditFieldl.Text=EditFieldl.Text+Me.ReadAl1() 
End Sub 
Wenn Sie Textdaten von einem anderen Computer empfangen, miissen Sie unter Umstanden die Textcodierung beach- 
ten. Stammt der Text aus einer anderen Applikation, von einem anderen Betriebssystem oder ist sogar in einer anderen 
Sprache verfasst, mtissen Sie REALbasic mitteilen, um welche Codierung es sich handelt. Weitere Informationen finden 
Sie im Abschnitt ,,Arbeiten mit Textcodierungen“ auf Seite 249. 


Die Methoden Read und ReadaAll akzeptieren einen optionalen Parameter, um die Codierung anzugeben. Verwenden Sie 
das Encodings-Objekt und geben Sie die gewiinschte Codierung an. Das Beispiel oben wurde entsprechend gedndert, 
um anzugeben, dass der gelesene Text im ANSI-Format codiert ist: 
Sub DataAvai lable() 

EditFieldl.Text=EditField1.Text+Me.ReadAll(Encodings.WindowsANSI ) 
End Sub 
Ab sofort kennt REALbasic die Codierung dieses Textes. Der Text wird also korrekt dargestellt und String-Operationen 
arbeiten wie erwartet. 
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Daten schreiben 


Mit der Write-Methode des TCPSocket-Steuerelements kénnen Sie Daten an die Anwendung senden, zu der eine Verbin- 
dung besteht. Die Write-Methode erwartet als Parameter eine Zeichenkette (String) mit den zu sendenden Daten. Im 
Beispiel wird der Text eines EditFields verschickt: 

TCPSocketl.Write EditFieldl.Text 


Wenn Sie den Text an eine Applikation verschicken, die eine bestimmte Codierung erwartet, miissen Sie den Text kon- 
vertieren, bevor Sie ihn verschicken. Verwenden Sie dazu die ConvertEncoding-Funktion. Diese erwartet als Parameter 
den Text und die Codierung. Das folgende Beispiel verschickt den Text eines EditFields in MacRoman-Codierung: 
TCPSocket1.Write ConvertEncoding(EditFieldl.text,Encodings .MacRoman) 


Wenn Sie die Write-Methode aufrufen, starten Sie einen Prozess, der die Daten auf den TCP-Socket schreibt. Je nach 
Implementierung und Provider gelten unterschiedliche Einschrinkungen. So kann die Datenmenge, die auf einmal ver- 
schickt wird, variieren. 


Davon sind nicht nur grofse Datenmengen betroffen. Stellen Sie also niemals Annahmen dariiber an, wieviele Daten zwi- 
schen einzelnen Aufrufen der SendProgress-Methode verschickt werden. Es ist normal, dass dieser Wert schwankt. 


Falls Sie mehr Daten als das vorgegebene Maximum verschicken, werden die Daten nicht auf einmal versendet. Stattdes- 
sen wird REALbasic Ihre Daten in einer Schleife verschicken und regemafig den SendProgress-Event auslésen. Verschi- 
cken Sie zu wenige Daten, werden diese auf Netzwerkebene gepuffert. Dies bedeutet, dass die Daten vielleicht noch gar 
nicht verschickt wurden, obwohl Sie bereits einen SendProgress- oder SendComplete-Event erhalten haben. 


Dieses Verhalten geht auf den sogenannten Nagle-Algorithmus zuriick, der die Netzwerkeffizienz steigert. Jedes Daten- 
paket wird mit einem Header (Kopf) versehen, bevor es verschickt wird. Dies geschieht automatisch auf Netzwerk- 
ebene. Auch wenn Sie sehr oft nur ein oder zwei Bytes verschicken, werden diese jeweils mit einem 40 Bytes grofen 
Header versehen. Ohne den Nagle-Algorithmus wiirde in diesem Fall das Netzwerk stark belastet werden. 


Momentan erlaubt es REALbasic nicht, diese Einstellung zu deaktivieren. 


Hinweis: Auch wenn Thre Anwendung nur ein einzelnes Byte und danach nichts weiter verschickt, wird dieses natiirlich 
iibertragen. Auch mit aktiviertem Nagle-Algorithmus. 


Schlussfolgerung: Gehen Sie niemals einfach davon aus, dass alle Daten versendet wurden. Warten Sie stattdessen den 
SendComplete-Event ab, der ausgelost wird, sobald der Versand abgeschlossen ist. Auch der bytesSent-Parameter des 
SendProgress-Events kann abhangig von der tibertragenen Datenmenge variieren. 


Tipp: Wenn Sie speziell in einem kleinen Netzwerk nur kleine Datenpakete verschicken, sollten Sie statt TCPSocket die 
UDPSocket-Klasse in Betracht ziehen. 


Fehlerbehandlung 


Fehler k6nnen beim Verbindungsaufbau, beim Senden und beim Empfangen von Daten auftreten. Fehler sind aber nicht 
immer das, was sie zu sein scheinen: Die Meldungen sind mit Vorsicht zu genieSen. Schliefst z.B. ein anderer Computer 
die Verbindung, wird der Error-Event-Handler des TCPSocket-Steuerelements aufgerufen. Der Fehlercode wird in der 
LastErrorCode-Eigenschaft der SocketCore Klasse abgelegt. In der Sprachreferenz finden Sie unter ,,SocketCore“ eine 
Liste der Fehlercodes samt ihrer Bedeutung. 

Die Fehlercodes teilen also Ihrer Anwendung mit, dass eine ordnungsgemafe Kommunikation unter den gegenwartigen 
Bedingungen nicht méglich ist. Ist zum Beispiel unter Mac OS 8/9 Open Transport nicht installiert, wird ein Fehler 
gemeldet. 
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Verwaisen eines Sockets 


Sockets k6nnen verwaisen. Das bedeutet, dass ein Socket auch dann weiter bestehen kann, wenn das Objekt, das ihn 
erzeugt hat (z.B. ein Fenster), nicht mehr existiert. Diese Eigenschaft wird ftir den ServerSocket benotigt. Wenn die Con- 
nect-Methode der SocketCore-Klasse oder die Listen-Methode der TCPSocket-Klasse aufgerufen oder ein Socket mit der 
AddSocket-Methode der ServerSocket-Klasse erzeugt wird, wird der Referenzzahler des Sockets um eins erhéht. 


Beispiel: Sie haben eine eigene Sockets-Unterklasse namens ,,MySpiffySocket* implementiert. Im Action-Event eines 
PushButtons k6nnen Sie dann folgenden Code verwenden: 

Dim s as MySpiffySocket 

s = New MySpiffySocket 

s.port = 7000 

s.address = "eincooler.server.de" 

s.connect 

Ein Socket bleibt also bestehen, bis er explizit geschlossen wird. Wenn Sie ein TCPSocket in ein Fenster gezogen, seine 
Connect- oder Listen-Methode aufgerufen und dann das Fenster geschlossen haben, gibt es zwei Referenzen auf dieses 
Socket. (In alteren REALbasic-Versionen gab es in diesem Fall nur eine Referenz, namlich die des Fensters.) Der Socket 
wird weiterhin funktionieren, solange die Verbindung besteht, obwohl das Fenster geschlossen wurde. Wenn Sie nicht 
die Connect- oder Listen-Methode aufgerufen haben, existiert nur eine Referenz auf das Socket (die des Fensters), die 
durch Schliefsen des Fensters ebenfalls geschlossen wird. 


Ein Socket wird geschlossen, indem Sie seine Close-Methode aufrufen oder indem die Gegenstelle die Verbindung been- 


det. Au&erdem werden alle noch offenen Sockets beim Beenden eines Programms anstandslos geschlossen, ohne dass 
Speicherlecks auftreten. 


Maximale Anzahl von Sockets 


In Mac OS X-Versionen kleiner 10.3 konnen Programme nur eine begrenzte Anzahl von Sockets 6ffnen. Das liegt daran, 
dass die zugrunde liegenden BSD-Sockets fiir jeden Socket, der aktuell an einen Port des Rechners gebunden ist, einen 
Dateideskriptor belegen und Mac OS X pro Applikation nur 256 Dateideskriptoren erlaubt. Da die Anzahl der Dateides- 
kriptoren vom verfiigbaren Speicherplatz abhangig ist und ihre Applikation und die verwendeten APIs ebenfalls Dateien 
gedffnet haben kGnnen, stehen normalerweise weniger als 256 Sockets fiir Verbindungen zur Verfiigung. Diese Proble- 
matik tritt unter Windows und Mac OS 9 nicht auf und ist kein Fehler von REALbasic, sondern charakteristisch fiir das 
BSD-System von Mac OS X. 


Hinweis: Das Problem kann in seltenen Fallen auch unter Linux auftreten. 


SchlieBen der Verbindung 

Wenn die Kommunikation mit dem entfernten Rechner beendet ist, konnen Sie die Verbindung trennen, indem Sie die 
Close-Methode des TCPSocket-Steuerelements aufrufen. 

TCPSocketl.Close 


E-Mails uber TCP/IP versenden und empfangen 


REALbasic bringt alles mit, was Sie zum Entwickeln eines E-Mail-Programms bendtigen. Ein typisches E-Mail-Programm 
verwendet die Protokolle POP (Post Office Protocol) und SMTP (Standard Mail Transfer Protocol). POP wird zum 
Empfangen, SMTP zum Verschicken von E-Mails eingesetzt. 


Mit POP3Socket und SMTPSocket stellt REALbasic zwei von TCPSocket abgeleitete Klassen bereit. 
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e POP3Socket enthalt Eigenschaften fiir Benutzernamen und Passwort und kann sich mit diesen beim E-Mail-Server 
anmelden, nach neuen Nachrichten suchen, Nachrichten empfangen und vom Server ldschen und die Verbindung 
zum Server beenden. 

© SMTPSocket arbeitet mit einer Warteschlange, in die zu versendende Nachrichten eingereiht werden. SMTPSocket 
bietet Methoden zum Einftigen einer Nachricht in die Warteschlange, zum Versenden der Nachrichten und zum Tren- 
nen der Serververbindung. 


REALbasic stellt weitere drei Klassen zum Verwalten von E-Mails zur Verfiigung: 


EmailMessage enthalt den Nachrichtentext, den mit EmailHeaders erzeugen Nachrichtenkopf und die mit 
EmailAttachment gespeicherten Anlagen. Einzelheiten zu diesen Klassen entnehmen Sie bitte der Sprachreferenz. 


REALbasic Professional untersttitzt sichere POP3- und SMTP-Verbindungen tiber die POP3SecureSocket- und SMTP- 
SecureSocket-Klassen, die von der SSLSocket-Klasse abgeleitet wurden und ansonsten mit POP3Socket und SMTPSocket 
identisch sind. Indem Sie die Secure-Eigenschaft der SSLSocket-Klasse auf True setzen, sorgen Sie dafiir, dass die Kom- 
munikation verschliisselt erfolgt. 


Kommunikation ber HTTP 


Das HTTP-Protokoll wird von Webbrowsern eingesetzt. (HTTP steht ftir Hypertext Transfer Protocol.) 


REALbasic stellt zur HTTP-Kommunikation die Klassen HTTPSocket und HTTPSecureSocket bereit. HTTPSocket ist eine 
Unterklasse von TCPSocket. HTTPSecureSocket wurde von SSLSocket abgeleitet und wird zur verschliisselten Kommu- 
nikation benutzt (nur in REALbasic Professional verftigbar). Die Klassen enthalten Methoden zum Laden von URLs und 
zum Absenden von Formularen. 


In REALbasic Professional steht das verschliisselte HTTPS-Protokoll zur Verftigung. Dieses konnen Sie aktivieren, indem 
Sie die Secure-Eigenschaft der SSLSocket-Klasse auf True setzen. Dadurch dndert sich der Standard-Port von 80 auf 443. 


Detaillierte Informationen zu Methoden, Events und Eigenschaften von HTTPSocket und HTTPSecureSocket finden Sie 
in der Sprachreferenz. 


Mit ServerSocket mehrere Verbindungen gleichzeitig verwalten 


Ein TCPSocket kann auf einem Port nur eine Verbindung gleichzeitig bedienen. Soll eine Anwendung mehrere Verbin- 
dungen tiber denselben Port unterstiitzen, bietet sich daftir das ServerSocket-Steuerelement an. Ein ServerSocket macht 
nichts anderes, als auf einem bestimmtem Port auf eingehende Verbindungen zu warten. 


Geht eine Verbindung beim ServerSocket ein, iibergibt es diese an einen TCPSocket und wartet auf weitere Verbindun- 
gen. Ohne ServerSocket ware dies schwierig zu realisieren. Dazu miisste ein TCPSocket nach Eingang einer Verbindung 
ein neues TCPSocket erzeugen, das auf eine weitere Verbindung wartet. Dabei k6nnte es leicht passieren, das in der zum 
Erzeugen des neuen Sockets und Starten des Listen-Prozesses notwendigen Zeit eine Verbindungsanfrage eingeht, die 
nicht beantwortet werden kann. 


Die Verbindungssuche eines ServerSockets wird gestartet, indem Sie seiner Port-Eigenschaft den abzuhGrenden Port 
iibergeben und dann seine Listen-Methode aufrufen. 


Wenn Sie unter Mac OS X oder Linux versuchen, einen Port kleiner 1024 anzusprechen, erhalten Sie einen Socket- 
Core.Error Nummer 105, es sei denn, Ihre Anwendung Iduft mit root-Zugriffsrechten. Dieses Verhalten ist von den 
Mac OS X- und Linux-Entwicklern so gewollt und soll Sicherheitsprobleme vermeiden helfen. 


Das ServerSocket-Steuerelement verwaltet einen Pool von TCPSockets, an die es eingehende Verbindungen tibergibt. 
Mit den Eigenschaften MinimumSocketsAvailable und MaximumSocketsConnected k6nnen Sie nach dem Start des Lis- 
ten-Prozesses deren Anzahl festlegen. Wenn Sie die MaximumSocketsConnected-Eigenschaft andern, wird keine beste- 
hende Verbindung getrennt (es werden unter Umstinden lediglich keine neuen Verbindungen aufgebaut, bis die 
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bestehenden getrennt wurden). Das Andern der MinimumSocketsAvailable-Eigenschaft kann den AddSocket-Event des 
ServerSockets auslsen, damit dieser seinen internen Puffer aufftillen kann. 


Wenn Sie die Listen-Methode des ServerSockets aufrufen, bestiickt dieser zunachst seinen internen Socket-Pool fiir ein- 
gehende Verbindungen, indem er den AddSocket-Event so oft aufruft, bis der interne Pool gefiillt ist. Der Pool umfasst 
die in der MinimumSocketsAvailable-Eigenschaft vorgegebene Anzahl plus zehn zusatzliche TCPSockets. (Hinweis: Wenn 
dieser Event Nil zurtickliefert, wird dadurch eine NilObjectException ausgelést). 


Der ServerSocket kann erst dann Verbindungen tibernehmen, wenn dieser Prozess abgeschlossen ist. Verbindungsanfra- 
gen, die wahrend des Bestiickens des Socket-Pools eingehen, werden abgewiesen. Wenn Sie feststellen wollen, ob der 
ServerSocket bereit ist, eingehende Verbindungen anzunehmen, k6nnen Sie seine IsListening-Eigenschaft abfragen. 


Der AddSocket-Event eines ServerSockets kann nur einen TCPSocket oder eine Unterklasse von TCPSocket zuriicklie- 
fern. Da UDP ein ,verbindungsloses* Protokoll ist (siehe Verbindungen tiber UDP mit UDPSocket“ auf Seite 375), hatte 
es keinen Sinn, wenn der ServerSocket mit UDPSockets hantieren k6nnte. 


Referenzzahler 


Wenn die AddSocket-Methode einen Socket liefert, wird der Referenzzahler nicht erhoht. Statt dessen wird der Socket 
intern verwaltet und der Referenzzahler erst dann erhdht, wenn der ServerSocket eine Verbindung an diesen Socket 
iibergibt. Wenn der ServerSocket vernichtet wird, bevor er Sockets aus dem internen Pool verwenden konnte, werden 
die unbenutzten Sockets ebenfalls vernichtet. Bis dahin ist namlich der ServerSocket das Elternobjekt der Sockets im 
Pool. Im Unterschied dazu bleiben die Sockets, denen der ServerSocket eine Verbindung tibertragen hat, bei Vernich- 
tung des ServerSockets bestehen und funktionieren weiter. Das bedeutet, dass TCPSockets verwaisen konnen. UDPSo- 
ckets und ServerSockets hingegen kénnen nicht verwaisen, sondern miissen einen Eigentiimer haben. Ist dies nicht der 
Fall, wird ein UDPSocket oder ServerSocket vernichtet, sobald es nicht mehr im Scope des Programms liegt. Allerdings 
bleiben dabei alle Verbindungen bestehen, die der ServerSocket an TCPSockets tibergeben hat. Es werden nur die TCP- 
Sockets zerstrt, die keine Verbindung aufgebaut haben. 


Hinweis: ServerSockets stehen nur in REALbasic Professional zur Verftigung. 


Sichere TCP-Verbindungen mit SSLSocket 


Das SSLSocket-Steuerelement kann die Kommunikation tiber TCP/IP mit Hilfe einer Technik namens Secure Sockets 
Layer (SSL) verschliisseln. SSL bietet eine hohe Sicherheit und wird auch zum Ubertragen von Kreditkartennummern 
oder vertraulichen medizinischen Daten verwendet. 
Aktuell unterstiitzt REALbasic vier verschiedene SSL-Versionen: 

Tabelle 43. SSL-Protokolle in REALbasic 

SSL v2 SSL Version 2 

SSLv23 SSL Version 3, lasst aber auch Version 2 zu 

SSLv3 SSL Version 3 

TLSv11 TLS (Transport Layer Security Version 1) 


Das Standardprotokoll ist SSLv23. Es ist mit den meisten Servern kompatibel. Das Protokoll muss in der Eigenschaft 
Connectionlype festgelegt werden, bevor mit der Connect-Methode eine Verbindung aufgebaut wird. Nach dem Aufbau 
einer Verbindung [asst sich das Protokoll nicht mehr andern. 


Nicht alle Server akzeptieren eine Verbindung mit dem voreingestellten Protokoll (SSLv23). Wenn Sie nicht wissen, 
welches Protokoll ein Server akzeptiert, probieren Sie einfach mehrere aus. Wenn der erste Versuch mit einem Fehler 
102 fehlschlagt, testen Sie die nachste Version. Stellen Sie sicher, dass dieser Prozess abgebrochen wird, wenn kein Pro- 
tokoll akzeptiert wird oder ein anderer Fehler auftritt. 


Um eine SSL-Verbindung aufzubauen, setzen Sie die Secure-Eigenschaft auf TRUE und rufen die Connect-Methode auf. 
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Mit der aktuellen Implementierung von SSLSocket ist es nicht méglich, einen verschliisselten ,,lauschenden“ Socket zu 
erzeugen. Wenn Sie also die Secure-Eigenschaft auf True setzen und die Listen-Methode aufrufen, wird auf Ihrem Rech- 
ner lediglich ein unverschliisselter Port ge6ffnet, der auf eine Verbindung wartet. Eine sichere Listen-Methode wird even- 
tuell zu einem spateren Zeitpunkt in REALbasic integriert. 


Fiir die SSLSocket- und ServerSocket-Steuerelemente gibt es keine eigenen Icons in der Werkzeugpalette. Da sich beide 
nicht von der Control-Klasse ableiten, kGnnen sie im Programmcode instanziiert werden. Alternativ konnen Sie einen 
SSLSocket tiber das Kontextmenti des Fenstereditors hinzuftigen. 


Hinweis: SSLSocket ist eine Unterklasse von TCPSocket und steht nur in REALbasic Professional zur Verfiigung. 


Verbindungen iber UDP mit UDPSocket 


Das User Datagram Protocol (UDP) ist die Grundlage des Hochgeschwindigkeitsnetzwerkverkehrs. UDP ist ein verbin- 
dungsloses Protokoll mit geringer Redundanz und ist nicht so sicher wie TCP. Da keine Verbindung aufgebaut werden 
muss, sind zur Verwendung eines UDPSocket-Steuerelements nicht annahernd so viele Schritte nétig wie beim 
TCPSocket-Steuerelement. 


Wie TCPSocket leitet sich das UDPSocket-Steuerelement von der neuen SocketCore-Klasse ab. Anders als TCPSocket ist 
UDPSocket mit keinem eigenen Symbol in der Steuerelementepalette vertreten. Da UDPSocket sich aber von der 
SocketCore-Klasse und nicht von der Control-Klasse ableitet, ist es nicht notwendig, ein UDPSocket-Steuerelement zur 
Instanziierung in einem Fenster abzulegen. Sie konnen es per Code mit den New-Operator instanziieren. 


UDPSocket muss einem bestimmten Port Ihres Computers zugewiesen werden. Sobald diese Zuweisung erfolgte, kann 
der UDPSocket verwendet werden. Er nimmt sofort alle am zugewiesenen Port eintreffenden Daten entgegen. Ein 
UDPSocket kann auch Daten verschicken. 


Datagramme 


Um zu unterscheiden, welche Daten von welchem Rechner kommen, verwendet UDPSocket eine Datenstruktur namens 
Datagramm. Ein Datagramm besitzt zwei Eigenschaften: Adresse (Address) und Daten (Data). Adresse ist die 
IP-Adresse des Rechners, der die Daten schickt, Daten sind die geschickten Daten. Auch beim Versenden von Daten 
miissen diese als Datagramme vorliegen. In diesen muss neben den Daten selbst die IP-Adresse des Empfangers und der 
Port, an den die Daten gesendet werden sollen, spezifiziert sein. 


UDPSocket Modi 


UDP Sockets lassen sich in verschiedenen Modi betreiben. 


© Der Modus, der einer Kommunikation iiber TCP am dhnlichsten ist, heift ,,Unicasting“. Er wird verwendet, wenn 
Daten nur an die IP-Adresse eines einzelnen Gerats verschickt werden. Das Datagramm ist also nur ftir einen Empfan- 
ger bestimmt. 

© Der zweite Modus nennt sich Broadcasting“ und verhalt sich so, als ob Sie eine Nachricht durch ein Megaphon an 
alle hinausposaunen. Wenn ein Rechner den von Ihnen spezifizierten Port zufallig zu diesem Zeitpunkt abhort, emp- 
fingt er die Daten. Auf diese Weise Informationen zu versenden ist sehr netzwerklastig, da durch Broadcasting viel 
Datenverkehr entsteht. 
Wenn Sie Daten mittels Broadcasting versenden, verlassen die Daten Ihr Subnetz nicht, werden also nicht in das 
Internet hinaus geschickt. 
Um Broadcasting zu verwenden, miissen Sie die Broadcast-Adresse Ihres Rechners kennen. Diese ist von Rechner zu 
Rechner unterschiedlich. UDPSocket stellt die Broadcastadresse in der Eigenschaft BroadcastAddress zur Verftigung. 

© Der dritte Modus, in dem sich UDPSockets betreiben lassen, heift ,Multicasting*. Dabei handelt es sich um eine 
Kombination der Modi ,,Unicasting“ und Broadcasting“. Multicasting verhalt sich ahnlich wie ein Chatroom. Nach 
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dem Betreten eines Chatrooms kénnen Sie sich mit jeder Person im Chatroom unterhalten. Wenn Sie den Chatroom 
betreten wollen, rufen Sie JoinMulticastGroup auf und geben an, welcher Gruppe Sie beitreten méchten. Der 
Group-Parameter ist eine besondere IP-Adresse, die sich Class D IP nennt. Sie umfasst den Bereich von 224.0.0.0 bis 
239.255.255.255. Stellen Sie sich die IP-Adresse einfach als Namen des Chatrooms vor. Wenn Sie sich mit zwei ande- 
ren Leuten unterhalten mochten, miissen alle drei Teilnehmer die JoinMulticastGroup mit der selben Class D 
IP-Adresse als Group-Parameter aufrufen. Zum Verlassen des Chatrooms miissen Sie LeaveMulticastGroup aufrufen 
und wiederum die Gruppe spezifizieren, die Sie verlassen méchten. Sie k6nnen gleichzeitig an beliebig vielen Multi- 
cast-Gruppen teilnehmen. Zum Versenden von Daten an eine Multicast-Gruppe geben Sie einfach deren IP-Adresse 
an. Alle Rechner dieser Gruppe werden die Nachricht erhalten. 

Wenn Sie die Daten, die Sie per Multicast versendet haben, auch selbst empfangen wollen, konnen Sie die SendToS- 
elf-Eigenschaft (auch loopback genannt) von UDPSocket auf TRUE setzen. Sie konnen aufserdem die Zahl der Router 
Hops eines Multicast-Datagramms festlegen (auch als Time to live bezeichnet). Beim Verschicken eines Datagramms 
durchlauft es auf dem Weg zu seinem Bestimmungsort mehrere Router. Mit jedem Router, den das Datagramm pas- 
siert, verringert sich die RouterHops-Eigenschaft um den Wert 1. Erreicht RouterHops den Wert 0, wird das Data- 
gramm zerstért. So k6nnen Sie mit einer grdfseren Genauigkeit festlegen, wer Ihr Datagramm erhalten kann. Hier 
einige Erfahrungswerte, wie grofs RouterHops gewahlt werden sollte: 


Tabelle 44. Empfehlungen fir die RouterHops-Eigenschaft 


Wert Beschreibung 


0 Gleicher Host 

| Gleiches Subnetz 
32 Gleicher Ort 

64 Gleiche Region 
128 Gleicher Kontinent 


255 ohne Einschrankung 
Hinweis: Wenn Thr Datagramm einen Router passiert, der kein Multicasting unterstiitzt, wird es sofort vernichtet. 


Aufgrund des verbindungslosen Charakters von UDP gibt es keinerlei Garantie dafiir, dass die Daten ihr Ziel erreichen. 
Um dieses Problem zu umgehen, k6nnen Sie ein eigenes Protokoll auf Grundlage des UDP-Protokolls entwickeln, das 
den Empfang von Daten bestitigt. 


UDPSocket arbeitet asynchron, die Connect-Methode aber synchron. Fiir den Fall, dass die Verbindung nicht hergestellt 
werden kann, wird umgehend ein Error-Event ausgelést und die IsConnected-Eigenschaft entsprechend gesetzt. 


Netzwerke ganz einfach 


Wenn Sie Netzwerkverbindungen nur zwischen REALbasic-Programmen aufbauen wollen, k6nnen Sie einige speziell 
daftir entwickelte Klassen verwenden. Diese basieren auf dem TCP-, bezichungsweise UDP-Protokoll, konnen aber nur 
mit anderen REALbasic-Applikationen kommunizieren. Wenn Ihr Programm beispielsweise mit einem FTP-Server kom- 
munizieren soll, miissen Sie die allgemeineren Klassen verwenden. 


Als Ausgleich fiir diese Einschrinkung sind nur wenige Zeilen Code nétig, um eine Kommunikation aufzubauen, und es 
ist kein fundiertes Hintergrundwissen tiber die Protokolle TCP und UDP natig. 


Die AutoDiscovery Klasse 


Die AutoDiscovery-Klasse organisiert die Netzwerkkommunikation zwischen REALbasic-Applikationen. Sie ist in der 
Lage, andere Applikationen im Netzwerk zu finden, die ebenfalls das ,,vereinfachte“ UDP-Protokoll als Kommunikations- 
grundlage verwenden. Mit der AutoDiscovery-Klasse kénnen Sie Nachrichten an einzelne Benutzer oder an Multi- 
cast-Gruppen schicken. 
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Einer Multicast-Gruppe beitreten 


Um einer Multicast-Gruppe beizutreten, miissen Sie lediglich deren Namen als Parameter fiir die Register-Methode der 
AutoDiscovery Klasse angeben. Jeder, der dieser Gruppe beitreten will, verwendet denselben Namen. Die Klasse kiim- 
mert sich intern selbst um eine giiltige Multicast-IP-Adresse. So treten Sie einer Multicast-Gruppe bei: 
AutoDiscoveryl.Register("MeineMulticastGruppe" ) 

Um die Mitglieder einer Gruppe zu ermitteln, rufen Sie die Methode GetMemberlList auf. Diese liefert ein Array von 
Strings mit IP-Adressen. Diese Methode konnen Sie immer wieder aufrufen, um die Liste zu aktualisieren. 


Der folgende Code zeigt die Mitglieder einer Gruppe in einer ListBox an: 


Dim s(-1) as string // Array deklarieren; GetMemberList vergréssert es selbst. 

Dim i as Integer 

s= AutoDiscoveryl.GetMemberList 

For i=0 to Ubound(s) //Ubound liefert den Index des letzten Elements 
ListBoxl.AddRow s(i) 

Next 


Eine Nachricht verschicken 


Um eine Nachricht an eine Gruppe zu verschicken, verwenden Sie die SendMessageToGroup-Methode. Diese akzeptiert 
eine numerische Kommando-ID und einen Text. Das folgende Beispiel setzt den Inhalt von EditField2 als Nachricht mit 
der Kommando-ID 50. 

AutoDiscoveryl.SendMessageToGroup(50,EditField2.Text) 

Um eine Nachricht an einen einzelnen Computer zu schicken, bendtigen Sie dessen IP-Adresse, die Sie mithilfe der Get- 
MemberList-Methode ermitteln konnen, die Kommando-ID und den Text. Die folgende Zeile schickt die gleiche Nach- 
richt an den Computer 192.168.1.118: 

AutoDiscoveryl.SendMessageToIndividual ("192.168.1.118",50,EditField2.Text) 


Die EasyUDPSocket- und EasyTCPSocket-Klassen 


Die Klassen EasyUDPSocket und EasyTCPSocket sind ,vereinfachte“ Versionen der UDPSocket- und TCPSocket-Klassen. 
Sie sind speziell fiir die Kommunikation zwischen REALbasic-Applikationen ausgelegt. 


Der gr6f&te Unterschied zwischen EasyTCPSocket und TCPSocket besteht darin, dass EasyTCPSocket nachrichtenbasiert 
arbeitet. Der Verbindungsaufbau entspricht dem des TCPSocket-Steuerelements. Zum Verschicken von Daten verwen- 
den Sie im Unterschied zu TCPSocket die SendMessage-Methode. Geht eine Nachricht ein, die dem EasyTCPSocket-Pro- 
tokoll entspricht, wird ein ReceivedMessage-Event ausgelést. 


Empfangen von Nachrichten 


Das Empfangen von Nachrichten k6nnte einfacher nicht sein. Der ReceivedMessage-Event der AutoDiscovery-Klasse 
wird immer dann ausgelést, wenn eine Nachricht von einem individuellen Rechner (inkl. Ihres eigenen) oder von einer 
Gruppe eingeht. Der Event-Handler liefert die IP-Adresse des Absenders, die Kommando-ID und den Nachrichtentext. 
Dazu reicht ein Event-Handler wie dieser villig aus: 

Sub ReceivedMessage(FromIP as String, Command As Integer, data as String) 


MsgBox FromIP + " sent us " + Str(Command) + ": " + data 
End Sub 


Wie Protokolle arbeiten 


Jede Art der Kommunikation macht es erforderlich, dass sich die beteiligten Seiten auf eine gemeinsame Sprache eini- 
gen. So verhilt es sich auch mit TCP/IP. Die verwendete Sprache nennt man in diesem Fall Protokoll. Es bestimmt die Art 
und Weise, wie Daten geschickt und empfangen werden. 
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Wenn Sie ein Programm schreiben, das eine TCP/IP-Verbindung mit einem anderen Programm herstellen soll, miissen 
Sie das Protokoll verstehen, das von dem anderen Programm verwendet wird. Beispielsweise wird im WWW das 
HTTP-Protokoll (HyperText Transfer Protocol) verwendet, fiir das Senden von E-Mails das SMTP-Protokoll (Simple Mail 
Transfer Protocol) eingesetzt und fiir das Empfangen von E-Mails das POP3-Protokoll (Post Office Protocol 3) benutzt. 
Vollstandige Beschreibungen dieser und anderer Protokolle finden Sie im Internet. Man nennt diese Beschreibungen 
RFCs (Request For Comments). Man findet Sie zum Beispiel, indem man auf www.google.de nach ,,.RFC* sucht. 


Wenn Sie ein Programm schreiben, das mit anderen von Ihnen selbst entwickelten Programmen kommunizieren soll, 
k6nnen Sie Ihr eigenes Protokoll definieren. 
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kapitel 3 REALbasic erweitern 


REALbasic ist unter anderem deswegen leicht erlernbar, weil es Ihnen erspart, sich mit den internen Abldufen des 
Betriebssystems auseinanderzusetzen. Sie mtissen die vielen tausend Funktionen, die das API (Application Programming 
Interface) des Betriebssystems ausmachen, nicht kennen. Das bedeutet aber auch, dass es méglicherweise die eine oder 
andere Funktion in REALbasic (noch) nicht gibt, die Sie bendtigen. Daher kann REALbasic erweitert werden. 


Inhalt 


e Toolbox-Funktionen aufrufen 

© AppleScripts aufrufen 

© Kommunikation mit AppleEvents 

© Schreiben und Benutzen von REALbasic-Plugins 
© Benutzung von PowerPC Shared Libraries 

© Office Automation 

e Active X-Komponenten 


Toolbox-Funktionen aufrufen 


Mit der Declare-Anweisung haben Sie Zugriff auf die Toolbox, und zwar sowohl auf der Mac- als auch auf der Win- 
dows-Plattform. Sie miissen die Declare-Aufrufe fiir die verschiedenen Plattformen voneinander trennen, dazu bietet 
sich die bedingte Compilierung an. Mit der Declare-Anweisung werden der Name der Toolbox-Funktion, die zugehGrige 
Shared Library und die Aufrufparameter bestimmt. Falls der Aufruf einen Wert zurtickliefert, mtissen Sie auch den Daten- 
typ des zurtickgelieferten Wertes angeben. 


Wenn eine Funktion auf beiden Plattformen zur Verfiigung steht, konnen Sie denselben Namen fiir beide Plattformen 
verwenden. Allerdings werden die Aufrufparameter meistens unterschiedlich sein. Auch in diesem Fall bietet sich 
bedingte Compilierung an, um die Aufrufe fiir die verschiedenen Plattformen voneinander zu trennen. 


Folgende Action-Methode eines Buttons verwendet den Macintosh Speech Manager, um den Text eines EditFields 
vorzulesen: 


dim s as string 
dim i as integer 
dif TargetMacOS then 
Declare Function SpeakString lib "SpeechLib" (SpeakString as pstring) as Integer 
ifendif 
s=editFieldl.text 
dif TargetMacOS then 
i=SpeakString(s) 
#felse 
MsgBox "Sprachausgabe wird nur auf dem Macintosh unterstitzt!" 
dfendif 


Wenn der Name der Toolbox-Funktion mit dem Namen einer REALbasic-Methode identisch ist, miissen Sie fiir die Tool- 
box-Funktion einen Alias-Namen verwenden. Wenn z.B. SpeakString der Name einer REALbasic-Methode ware, konnten 
Sie das Beispiel nicht wie oben gezeigt programmieren. Stattdessen kdnnten Sie folgende Syntax verwenden: 


Declare Function MySpeakString lib "SpeechLib" Alias "SpeakString" (SpeakString as pstring) as Integer 
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Um die Toolbox-Funktion aufzurufen, mtissten Sie dann MySpeakString verwenden. 


Weitere Informationen und Beispiele entnehmen Sie bitte der Beschreibung des Declare-Befehls in der Sprachreferenz. 


AppleScripts aufrufen 


AppleScript ist die Skript-Sprache von Apple, mit der man Anwendungen auf einfache Weise steuern kann. REALbasic 
unterstiitzt AppleScript. Sie k6nnen mit dem im Mac OS enthaltenen Skripteditor ein AppleScript-Skript schreiben und 
es dann in Ihrem REALbasic-Projekt aufrufen. 


Hinweis: AppleScript ist nur auf dem Macintosh verfiigbar. 


AppleScript vorbereiten 


Das komplette Skript muss in einem On-Run-Handler untergebracht sein, der z.B. so aussieht: 


on run 
//Hier steht das eigentliche Skript 
end run 


Das Skript muss im Skripteditor als ,Programm“ abgespeichert werden. Diese Option kdnnen Sie im_,,Sichern 
unter... .“-Dialog des Skripteditors aktivieren. 
Importieren eines AppleScript-Skripts 


Ziehen Sie das compilierte Skript in Ihr Projektfenster. Das Skript erscheint dort mit einem AppleScript-Icon. 


Abb. 275: Ein compiliertes AppleScript im Projektfenster 
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REALbasic speichert einen Alias des Skripts in der Projektdatei, nicht das Skript selbst. Sein Name wird kursiv dargestellt. 
Erst beim Erzeugen eines Stand-Alone-Programms wird das Skript in die fertige Applikation eingebaut. 
Parameter an ein AppleScript ibergeben 


Wenn Sie ein Skript schreiben und diesem Parameter tibergeben méchten, miissen Sie die Parameter hinter dem on 
run-Kommando in geschweifte Klammern setzen. Hier werden die Parameter x und y an das Skript tibergeben: 


on run {x,y} 
//Hier steht das eigentliche Skript 
end run 


Werte aus einem AppleScript-Skript zurickgeben 


Skripte, die einen Wert zurtickliefern, werden wie Funktionen behandelt. Verwenden Sie im Skript das Return-Kom- 
mando, um einen Wert zuriickzuliefern. Das folgende Beispielskript erhalt als Parameter das Alter in Tagen und gibt das 
Alter in Jahren zuriick (Schaltjahre werden nicht beriicksichtigt): 

on run {daysOld} 


return daysO1d/365 
end run 
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Aufrufen eines AppleScript-Skripts 


Skripts werden wie Methoden oder Funktionen aufgerufen. 

Hier wird ein Skript aufgerufen, das die Lautstarke des Macs auf 5 setzt: 
SetSoundLevel 5 

Und so kann man ein Skript aufrufen, das einen Wert zurtickgibt: 


Dim level as Integer 
level=GetSoundLevel () 


Entfernen eines AppleScript-Skripts 


Sie lschen ein Skript aus dem Projekt, indem Sie es im Projektfenster anklicken und dann die Backspace-Taste driicken. 
Alternativ dazu konnen Sie einen ctrl-Klick auf das Skript ausftihren und im dann erscheinenden Kontextmenti den 
Mentipunkt Léschen aufrufen. 


Kommunikation Uber AppleEvents 


AppleEvents sind das Herzsttick der Kommunikation zwischen den Anwendungen, die auf einem Mac laufen. Wenn Sie 
ein AppleScript aufrufen, dann werden alle Aktionen des Skripts tiber AppleEvents abgewickelt. Wenn Sie im Finder 
einen Neustart ausldsen, schickt der Finder ein ,Quit“-AppleEvent an alle laufenden Programme. Alle Programme miis- 
sen dieses AppleEvent unterstiitzen. 


Ein AppleEvent-Objekt wird mit der Funktion NewAppleEvent erzeugt. AppleEvents bestehen aus drei Teilen: Einer 
Event-Klasse, einer Event-ID und dem Creator-Code der Zielanwendung. 


Die Event-Klasse und die Event-ID definieren gemeinsam ein eindeutiges AppleEvent. Die Event-Klasse ist daftir 
gedacht, Events in Gruppen zusammenzufassen. Es gibt zahlreiche Standard-Events, von denen einige unbedingt von 
jedem Programm unterstiitzt werden miissen. Viele Programme bieten dariiber hinaus auch eigene Events an, die spezi- 
elle Funktionen des Programms beriicksichtigen. Informationen dazu erhalten Sie entweder in der Dokumentation des 
Programms oder beim Programmautor selbst. 


Hinweis: AppleEvents funktionieren nur auf einem Macintosh. 


AppleEvents senden 


Nachdem Sie das AppleEvent-Objekt angelegt haben und die nétigen Parameter festgelegt sind, senden Sie das Apple- 
Event an die Zielanwendung. Dazu bedienen Sie sich der Send-Methode des AppleEvent-Objekts. 


Im nichsten Beispiel wird ein AppleEvent erzeugt, das den Finder auffordert, den Mac neu zu starten. Die Klasse des 
Events ist ,FNDR“ und die Event-ID heifst ,,rest“ (ftir Restart). Der Creator-Code des Finders lautet ,MACS“. Die 
Send-Methode liefert True zuriick, wenn das Event erfolgreich abgeschickt werden konnte: 

dim ae as AppleEvent 

ae=newAppleEvent("FNDR", "rest", "MACS" ) 

if not ae.send then 


msgBox "Der Computer konnte nicht neu gestartet werden." 
end if 


AppleEvents empfangen 


Um AppleEvents empfangen zu konnen, muss Ihr Projekt iiber ein Objekt der Application-Klasse verfiigen. Nur ein 
Application-Objekt kann auf AppleEvents reagieren, da es einen HandleAppleEvent-Event-Handler hat. Dieser empfangt 
das eingehende AppleEvent. 
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Dieser Event-Handler empfingt das AppleEvent-Objekt, die Event-Klasse und die Event-ID. Bestimmte AppleEvents 
muss Ihre Anwendung unterstiitzen. Eines davon ist das Quit-AppleEvent. 


Im Beispiel wird die Quit-Methode aufgerufen, wenn der HandleAppleEvent-Event-Handler ein Quit-Event empfangt: 


Function HandleAppleEvent(Event as AppleEvent, eventClass as String, EventID as String) as Boolean 
if eventClass="aevt" and eventID="quit" then 
//Der Finder fordert das Programm zur Beendigung auf 
beep 
msgBox "Jetzt ist leider Schluss." 
quit 
end if 
End Function 
Sie konnen ftir Ihr Programm eigene AppleEvent-Klassen und Event-IDs definieren, auf die Ihr Programm mit verschie- 
denen Aktionen reagieren kann. 


Wenn Ihr Programm feststellen soll, ob der Mac gerade aus dem Ruhezustand erwacht ist, mtissen Sie nur auf den 
,wake“-AppleEvent reagieren, der dann vom Mac OS an alle Applikationen verschickt wird. 


Dazu muss es in Ihrem Projekt eine Application-Klasse geben. Der HandleAppleEvent-Event-Handler der Applica- 
tion-Klasse wird jedes Mal ausgeldst, wenn Ihre Applikation einen AppleEvent erhalt. Dem Event-Handler wird dabei der 
AppleEvent, die EventClass und die EventID tibergeben. Um festzustellen, ob es sich um die Aufwach-Meldung handelt, 
iiberpriifen Sie, ob EventClass gleich ,,pmgt“ und eventID gleich ,wake“ sind. Wenn der AppleEvent diese Werte enthilt, 
ist der Mac gerade aus dem Ruhezustand erwacht. 


Hinweis: AppleEvent-Klassen und IDs sind case-sensitiv. AppleEvents konnen nicht empfangen werden, wenn ein Pro- 
gramm im Debugger der IDE ablauft. Nur die Stand-Alone-Applikation kann AppleEvents empfangen. 


AppleEvents fiir Fortgeschrittene 


AppleEvents konnen sehr spezialisierte Daten enthalten. Es ist méglich, AppleEvents zu programmieren, die Daten ftir 
einen Web-Server verarbeiten. Mehr Informationen finden Sie unter AppleEvent-Klasse in der Sprachreferenz. 


Schreiben und Benutzen von REALbasic Plugins 


Viele Anwendungen verftigen tiber ein eigenes Plugin-Format. Netscape Navigator, Adobe PhotoShop oder 4th Dimen- 
sion sind nur einige Beispiele. Plugins erweitern das Leistungsspektrum eines Programms durch externe Module. Zum 
Beispiel gibt es ein Plugin ftir den Navigator, mit dem man QuickTime-Filme ansehen kann, die in Web-Seiten eingebun- 
den sind. 

REALbasic hat ebenfalls ein eigenes Plugin-Format. Plugins werden in C oder C++ geschrieben. James Milne von 
Essence Software hat zum Beispiel ein REALbasic-Plugin geschrieben, das bestimmte Sounddateien abspielen kann. 
Auch fiir die Anbindung an Datenbankserver verwendet REALbasic Plugins. Sie konnen auch andere Datenbank-Engines 
als die standardmafig untersttitzten verwenden, indem Sie ein entsprechendes Plugin programmieren oder von einem 
Dritthersteller erwerben. 


Wenn Ihre Applikation fiir Mac OS X gedacht ist, mtissen die Plugins carbonisiert sein. 


Plugins installieren 


Plugins werden einfach in einem Ordner namens ,,Plugins“ abgelegt. Dieser muss sich im selben Verzeichnis befinden, in 
dem auch das REALbasic-Programm liegt. Dort findet REALbasic sie automatisch. 
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Plugins benutzen 


Einige Plugins erscheinen als Steuerelemente in der Steuerelementepalette von REALbasic, und zwar unterhalb der ein- 
gebauten Steuerelemente. 

Ein Plugin-Steuerelement wird genauso wie jedes andere Element der Steuerelementepalette verwendet, indem Sie es 
auf ein Fenster ziehen. Das Eigenschaftenfenster zeigt dann die Eigenschaften des Plugin-Steuerelements an. 

Plugins konnen aber auch aus einer Sammlung von Methoden bestehen, die kein Benutzer-Interface haben. Sie erschei- 
nen dann auch nicht im Benutzer-Interface von REALbasic. Diese Plugins miissen tiber eine Dokumentation verfiigen, 
die beschreibt, welche Methoden das Plugin bietet und wie man sie einsetzt. 


Plugins im fertigen Programm 


Beim Erzeugen einer Stand-Alone-Anwendung werden alle Plugins automatisch im Programm abgelegt. 


Eigene Plugins schreiben 


Wenn Sie C oder C+ + beherrschen, kGnnen Sie selbst Plugins ftir REALbasic schreiben. Das REALbasic Plugin Software 
Development Kit (SDK) ist auf der REALbasic CD und auf dem FTP-Server von REAL Software zu finden und enthilt alle 
bendtigten Informationen und Beispieldateien ftir den Metrowerks CodeWarrior. 


Benutzung von PowerPC Shared Libraries 


PowerPC Shared Libraries sind Dateien mit Routinen, die Sie aufrufen konnen und denen auch Parameter tibergeben 
werden kGnnen. Wie der Name schon andeutet, laufen die PowerPC Shared Libraries nur auf Macs mit PowerPC-Prozes- 
sor. Auferdem miissen sie carbonisiert sein, wenn sie unter Mac OS X verwendet werden sollen. Shared Libraries k6n- 
nen ein guter Weg sein, um extern Code unterzubringen, was insbesondere dann sinnvoll ist, wenn sich mehrere 
Programme denselben Code teilen sollen. 


Zugriff auf Kommandos in Shared Libraries 


Um Kommandos (oder auch ,,Entry Points“) in Shared Libraries aufzurufen, mtissen Sie die Shared Library in Ihr Projekt- 
fenster ziehen. 

Danach miissen Sie die Entry-Points definieren, auf die Sie zugreifen mochten. Dazu verwenden Sie den Entry-Point-Edi- 
tor. Sie k6nnen diesen aufrufen, indem Sie im Projektfenster einen Doppelklick auf die Shared Library ausftihren. Im 
Entry-Point-Editor werden die von Ihnen definierten Entry-Points angezeigt. 


Abb. 276: Der Entry-Point-Editor 
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Klicken Sie den Knopf Neu..., um einen neuen Entry-Point zu definieren oder selektieren Sie einen vorhandenen 
Entry-Point und klicken auf Andern, um diesen zu verandern. Im darauf folgenden Fenster geben Sie die Parameter ein. 
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Abb. 277: Das Neuer Entry-Point-Fenster 


Neuer Entry-Point 


Methode: | } 


Parameter: 


Ruckgabetyp: 


Sie miissen die Namen der Entry-Points und die Datentypen ihrer Parameter kennen, um die Library verwenden zu k6n- 
nen (siehe Dokumentation der jeweiligen Library). 


Kommandos in Shared Libraries aufrufen 


Einen Entry-Point einer Shared Library rufen Sie so auf, als ob es sich um eine normale Methode handeln wiirde. Im Bei- 
spiel wird der HMSetBalloons-Entry-Point aufgerufen, mit dem die Balloon-Help ein- und ausgeschaltet werden kann. Da 
dies eine Funktion ist, wird das Ergebnis der Variablen err zugewiesen: 


Dim err as Integer 
err = InterfaceLib.HMSetBalloons(1) 


Microsoft Office Automation 


REALbasic enthilt vier Klassen, mit denen Sie Microsoft Office Applikationen direkt von REALbasic aus programmieren 
k6nnen. Auf dem Macintosh wird Office X, unter Windows Office 2000 unterstiitzt. Unter Mac OS 8/9 ist Office Automa- 
tion nicht verftigbar. Natiirlich muss auch Microsoft Office auf dem Rechner installiert sein, auf dem die erzeugte Appli- 
kation gestartet werden wird. 


Tabelle 45. Die vier Klassen der Office Automation 


Name Beschreibung 

ExcelApplication Abgeleitet vom OLE-Objekt und automatisiert Excel 

PowerPointApplication  Abgeleitet vom OLE-Objekt und automatisiert PowerPoint 

WordApplication Abgeleitet vom OLE-Objekt und automatisiert Word 

Office Enthalt alle weiteren Bestandteile zur Automatisierung der Office Applikationen 


Hinweise zur Office Automation unter Mac OS X 


Da die OLE-Bibliotheken privat im Office-Paket gespeichert sind, mtissen Sie Ihre compilierte Anwendung in den 
Office-Ordner innerhalb des Office X-Ordners legen (normalerweise /Programme/Microsoft Office X/Office). Damit Sie 
Thre Office-Automation-Anwendung debuggen k6nnen, miissen Sie sie ebenfalls in diesen Ordner legen. In einer 
zukiinftigen Version soll es méglich sein, die Anwendungen auch auSerhalb des Office-Ordners zu benutzen. 


Office Automation under REALbasic im Vergleich zu VisualBasic 


Ausgehend von der Application-Klasse: Wenn Sie VBA-Code innerhalb Excel, PowerPoint oder Word schreiben, gibt es 
bereits eine Instanz der Application-Klasse. Beispiel: 


Dim pres as Presentation 

Dim slidel as Slide 

Set pres = Presentations .Add 

' The above is the same as saying: 

Set pres = Application.Presentations.Add 

Set slidel = pres.Slides.Add(1, ppLayoutText) 
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In PowerPoint funktioniert dieser Code, da bekannt ist, was ein Presentation-Objekt ist. Wenn Sie diesen Code in Excel 
oder Word eingeben, wird dies zu einem Fehler fiihren. Wie wiirde dieser Code in RB aussehen? Hier ist der Code: 

Dim PowerPoint as new PowerPointApplication 

Dim pres as PowerPointPresentation 

Dim slidel as PowerPointSlide 

pres = PowerPoint.Presentations.Add 

slidel = pres.Slides.Add(1, Office.ppLayoutText) 

Es gibt hier tatsachlich nur zwei Unterschiede. Der erste ist, dass alle PowerPoint-Objekte mit ,,PowerPoint“ beginnen, 
alle Word-Objekte mit Word“ und alle Excel-Objekte mit ,Excel“. Der zweite Unterschied ist, dass sich alle konstanten 
Werte im Office-Modul befinden. Damit gibt es keine Probleme im Namensraum in REALbasic. 


Ubergeben von benannten Parametern: Wird von REALbasic nicht unterstiitzt. Mit etwas Aufwand kénnen Sie es trotz- 
dem realsieren. Zundchst miissen Sie sich mit dem OLEObject vertraut machen. Dazu konnen Sie in der Sprachreferenz 
nachschlagen oder folgendes Beispiel als Grundlage nehmen. Im Beispiel zeichnen wir mit Word ein ,Suchen und Erset- 
zen‘-Makro auf und realisieren dann dasselbe mit REALbasic. 


Das Word-Makro: 


Selection.Find.ClearFormatting 
Selection.Find.Replacement.ClearnFormatting 
With Selection. Find 

.Text = "find this" 


.Replacement.Text = "replace with" 
-Wrap = wdFindContinue 
.Format = false 


.MatchCase = false 

.MatchWholeWord = false 

.MatchWildcards = false 

.MatchSoundsLike = false 

.MatchAllWordForms = false 

End With 

Selection.Find.Execute Replace:=wdReplaceAl] 


Der passende REALbasic-Code: 


Dim word as new WordApplication 

Dim find as WordFind 

find = word.Selection.Find 
find.ClearFormatting 
find.Replacement.ClearFormatting 
find.text = "find this" 
find.Replacement.Text = "replace with" 
find.Wrap = Office.wdFindContinue 
find.Format = false 


find.MatchCase = false 
find.MatchWholeWord = false 
find.MatchWildcards = false 
find.MatchSoundsLike = false 
find.MatchAl1lWordForms = false 


// Now the fun stuff 

Dim replaceParam as new OLEParameter 

eplaceParam.Value = Office.wdReplaceAl | 

// according to the docs on Find.Execute the Replace parameter is the 11th 
eplaceParam.Position = 11 

find.Execute replaceParam 
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Das war schon alles. Der schwierigste Teil ist es, die Position des benannten Parameters herauszufinden. Dazu miissen 
Sie VBA starten und die Position im VBA-Objekt-Browser ermitteln. 


Konflikte mit Schliisselwortern: Es gibt bestimmte Woérter in RB (diese werden normalerweise hervorgehoben darge- 
stellt, wie ,,Select“ oder End"), die nicht als Namen von Methoden oder Eigenschaften verwendet werden kénnen. 
Ungliicklicherweise verwendet Excel einige dieser Namen. Um dieses Problem zu umgehen, kénnen Sie der Eigenschaft 
oder Methode einen Unterstrich anhangen. Zum Beispiel: 

Excel.Range("Al", "A3").Select_ 

Da ,,Select* ein Schliisselwort ist, kKGnnen Sie in einem solchen Fall den Unterstrich anhangen und RB wird dies als 
,select* an Excel weitergeben. 


Laden der Office Dokumentation: Wenn Ihnen die Auto-Vervollstandigung nicht ausreicht oder Sie weitere Informatio- 
nen tiber die Office-Klassen ben6tigen, k6nnen Sie VBA starten und tiber den Objekt-Browser die Klassen naher betrach- 
ten. Unter Office fiir Windows kénnen Sie in den Office-Type-Libraries nachschlagen, die die Dokumentation fiir 
PowerPoint, Word und Excel enthalten. Um diese zu laden, wahlen Sie den Mentipunkt Datei/ActiveX Komponente 
hinzufiigen... Unter dem Karteireiter ,,Referenzen“ konnen Sie die entsprechende Library auswahlen. Beispielsweise 
enthalt die ,Microsoft Word #.# Object Library“ die Dokumentation fiir Word, wobei #.# die Versionsnummer ist. 


Problembehebung 
Wie finde ich heraus, ob die OLE-Bibliotheken installiert sind? 


Eine Moglichkeit ist es, in Word unter Extras/Makro den Visual Basic-Editor zu starten und die Automation 
anzuwenden. 


Folgende Schritte sind dazu notig: 
Starten Sie Word. 

Offnen Sie den Visual Basic Editor. 
Fiigen Sie ein Benutzerformular ein. 


Legen Sie einen Knopf auf das Formular. 


SI ES OS 


Schreiben Sie folgenden Code in den Click-Event des Knopfes: 
Dim obj as Object 

Set obj = CreateObject("PowerPoint.Application") 
obj.Activate 


6. Starten Sie das Programm und klicken den Knopf an. 


7. Wenn PowerPoint startet und Sie keine Fehler erhalten, sind die OLE Bibliotheken installiert. 


Wie kann ich auf Fehler reagieren? 
Da Fehler von OLE durchgereicht werden, mtissen Sie OLE-Exceptions abfangen. Diese liefern das letzte Kommando, 
das fehlschlug, zusammen mit weiteren Informationen tiber die Exception. 


Dim word as new WordApplication 
word. ShowClipboard 

exception err as OLEException 
msgbox err.message 


Weiterfiihrende Dokumentation 


© Microsoft Visual Basic for Applications (VBA) Online-Hilfe 
© www.microsoft.com/office/developer/default.html 
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@ Developing Solutions with Office 2000 Components and VBA‘ von Peter G. Aitken 
© Microsoft Office 2000/Visual Basic Programmer’s Guide 


ActiveX-Komponenten 


ActiveX-Komponenten sind standardisierte User-Interface-Elemente oder programmierbare Objekte, mit deren Hilfe Sie 
sehr schnell eine spezialisierte Benutzeroberflache entwickeln k6nnen. In der Windows-Version von REALbasic fiigen Sie 
der Steuerelementepalette ActiveX-Steuerelemente und -Komponenten hinzu, indem Sie den Mentibefehl Datei/ 
ActiveX Komponenten hinzufiigen aufrufen. Dann erscheint eine Liste der auf Ihrem PC verfiigbaren ActiveX-Steuer- 
elemente und -Komponenten. 


Abb. 278: ActiveX-Komponenten 
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OK ek 2 Abbrechen 


Wenn Sie ActiveX-Steuerelemente oder -Komponenten auswahlen, werden diese der Steuerelementepalette abgelegt. 
Danach kénnen Sie ActiveX-Steuerelemente und -Komponenten wie regulare REALbasic-Objekte verwenden. 
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Detaillierte Informationen tiber die Programmierung von ActiveX-Komponenten finden Sie bei Microsoft in der MSDN 
Bibliothek unter: 


http://msdn.microsoft.com/library/ 
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Beim Erzeugen einer eigenstandig ablauffahigen Anwendung (,,Stand-Alone-Applikation“) aus Ihrem Projekt sollten Sie 
einige Dinge beachten, die in diesem Kapitel vermittelt werden. 

Mit REALbasic k6nnen Sie zwei Arten von Stand-Alone-Applikationen erzeugen: Vollversionen und Demos. Die Vollver- 
sion einer Stand-Alone-Applikation verhalt sich genauso wie eine Applikation, die Sie aus der Entwicklungsumgebung 
iiber Debug/Run starten, mit dem Unterschied, dass daftir kein REALbasic erforderlich ist (deswegen auch 
Stand-Alone-Applikation). Eine Demoversion hat die Funktionalitat der Vollversion mit der Einschrankung, dass sie sich 
nach ftinf Minuten automatisch beendet. 

Mit der Professional-Version von REALbasic lassen sich Stand-Alone-Applikationen als Vollversion fiir Macintosh, Win- 
dows und Linux erzeugen. Mit der Standard-Version von REALbasic knnen Sie nur ftir diejenige Plattform Vollversionen 
erstellen, unter der Ihr REALbasic lauft. Fiir die anderen Plattform konnen Sie lediglich Demversionen erstellen. 


Inhalt 


Das Programm erzeugen 

Bestandteile des Projektfensters 

Eigene Icons verwenden 

Den Creator-Code registrieren 

Verwenden und Programmieren von REALbasic-Plugins 
Der Thread-Manager 
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Ein Stand-Alone-Applikation wird erzeugt, indem Sie Ablage/Applikation erzeugen aufrufen oder Shift-38-M (Win- 
dows: Strg-Shift-M) driicken. 


REALbasic wird eine Stand-Alone-Applikation fiir das Betriebssytems erzeugen, das auf Ihrem Rechner lduft (Mac OS X, 
Classic oder Windows). Standardmifig erhalt Ihre Applikation den Namen ,,Mein Programm‘ oder ,,Mein Programm 
(Mac OS X)“ und wird im selben Verzeichnis wie Thr Projekt abgelegt. 


Jede Stand-Alone-Applikation enthdlt eine Bibliothek nahezu aller Steuerelemente, Klassen, globalen Methoden etc., die 
REALbasic unterstiitzt. Dazu gehGren auch alle Plug-ins, die in Ihrer Anwendung Verwendung finden. Dies bedeutet 
auch, dass Ihre Stand-Alone-Applikation, zum Beispiel Code fiir den Umgang mit Listboxen enthalt, auch wenn Sie in 
Threr Anwendung von ListBoxen keinen Gebrauch machen. 


Sobald REALbasic die Applikation erzeugt hat, wird das Schreibtischfenster mit der Applikation in den Vordergrund 
geholt. Sie kGnnen dann mit einem Doppelklick die Anwendung testen. 
Wenn Sie nicht méchten, dass das Schreibtischfenster mit der Applikation in den Vordergrund riickt, konnen Sie diese 


Einstellung unter REALbasic/Einstellungen/Erzeugen-Prozess (Bearbeiten/Einstellungen unter Mac OS Classic 
und Windows) deaktivieren. 
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Abb. 279: Einstellungen fiir den Erzeugen-Prozess 
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Abbrechen 


Beim Erzeugen einer Applikation wird eine eventuell vorhandene Datei gleichen Namens ohne Riickfrage tiberschrie- 
ben. Wenn Sie eine altere Version Ihrer Anwendung behalten mdchten, miissen Sie diese in einen anderen Ordner ver- 
schieben, bevor Sie eine neue Version der Applikation erzeugen. 


Eine Applikation automatisch erzeugen 


Sie kénnen eine Applikation auch tiber ein AppleScript erzeugen. Das REALbasic-Dictionary enthalt dazu den 
Build-Befehl. Der Build-Befehl verweist auf das REALbasic-Projekt. Wird er ausgefiihrt, erzeugt er gema{s den Compi- 
ler-Einstellungen eine oder mehrere Stand-Alone-Applikationen. 


Eigenschaften der Stand-Alone-Applikation festlegen 


Alle Einstellungen, die mit dem Erzeugen einer Stand-Alone-Anwendung zusammen hangen, finden Sie im Dialog 
Ablage/Compiler-Einstellungen. Hier knnen Sie der Applikation einen eigenen Namen und eigene Programm-Icons 
geben und festlegen, fiir welche Zielplattformen Programme erzeugt werden sollen. 


1. Wahlen Sie Ablage/Compiler-Einstellungen oder driicken Sie alt-Shift-88-M. 


Abb. 280: Die ,,Einstellungen fiir Applikation erzeugen”-Dialogbox 


Einstellungen fiir Applikation erzeugen 


Erzeuge fir: wm Mac OS X 
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Windows-Einstellungen 
Linux/x86 Settings 


Compiler-Einstellungen Version: 
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Sprache 
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0 


Lange Version: 


Zusatzinfo: 


Im Sprache-Ment ist die Sprache 


Vereinigte Staaten |v} t aye 
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: (Standard System) [5% —— ——— rojekteinstellungen als 


( Icons...) ( 


Abbrechen) Vorgabesprache gewahlt wurde. 


Der Dialog verwendet drei Auswahlebenen, die Sie tiber das Popup-Menii ansteuern k6nnen. 
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Die Checkboxen hinter ,,Erzeuge fiir“ legen die Zielplattform ftir Ihre Applikation fest. Sie konnen ftir mehrere Plattfor- 
men gleichzeitig eine Applikation erzeugen. Per Voreinstellung erzeugt REALbasic nur ftir das Betriebssystem eine Appli- 
kation, unter dem Sie arbeiten. Sie haben folgende Auswahl: 


© Mac OS X: Erzeugt eine Applikation im Macho-O oder PEF-Format. 

© Mac OS 8-9: Erzeugt eine Applikation fiir Mac OS 8/9 (PPC Version). 68k-Programme k6nnen nicht erzeugt werden. 
Die letzte Version, die dies unterstiitzt, ist REALbasic 3.5.2. 

© Windows 98, NT, 2000, XP: Erzeugt eine Applikation, die unter den genannten Windows-Versionen lauffahig ist. 

© Linux/x86: Erzeugt eine Applikation fiir x86-Linux. Linux-Applikationen benétigen GIK+ 2.0 oder héher. Fiir weitere 
Informationen besuchen Sie die Webseiten unter http://www.gtk.org. 


Versions-Information 


Die meisten Informationen, die Sie in der Rubrik Versions-Information eingeben kdnnen, erscheinen, wenn ein 
Mac-Benutzer im Finder auf das Programmsymbo! klickt und Ablage/Information/Allgemeine Information (38-1) auf- 
ruft. Der Text, den Sie unter Zusatzinfo eintragen k6nnen, erscheint direkt unterhalb des Programmnamens. Der Text 
aus dem Feld Lange Version erscheint unterhalb des Anderungsdatums. 


Wenn der Benutzer im Finder Bearbeiten/Voreinstellungen wahlt und unter Darstellungen die Version-Checkbox 
der Spaltenanzeige aktiviert, wird in der Listenansicht des Finders die Kurze Version angezeigt. 


Unter Mac OS X finden Sie diese Option fiir Fenster in Listenansicht unter Darstellung/Darstellungsoptionen 
einblenden: 
© REALbasic450Logos Folder 


O Nur dieses Fenster 
@ Alle Fenster 


Symbolgréke: A 
6-0 


TextgréRe: 12 pt iz 


Spaltenanzeige: 

wv Anderungsdatum 

_ Erstellungsdatum 

wv GréRe 

Cart 

Version 
Kommentar 


@ Relatives Datum 
Alle GréBen berechnen 


Alle anderen Informationen sind nicht sichtbar, werden aber in der vers-Resource Ihrer Anwendung gespeichert. In 
der vers-Resource lassen sich Informationen zu einer einzelnen Anwendung oder einer Gruppe von Dateien ablegen. 
Eine vers-Resource mit ID=1 steht ftir die Versions-Information einer Applikation. Eine vers-Resource mit ID=2 steht 
fiir die Versions-Informationen einer Gruppe von Dateien. Die folgende Abbildung veranschaulicht die Beziehung zwi- 
schen den Versions-Information-Einstellungen und den Einstellungen ftir die vers-Resource. 


Das Programm erzeugen 391 


Abb. 281: Compiler-Einstellungen in REALbasic und ,,vers"-Resources in ResEdit 
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Lange Version: |1.01b37 
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Icons...) (Abbruch ) GCG 


Auch wenn die von ResEdit verwendete Namensgebung etwas verwirren mag, entspricht der String im Long 
version-Feld fiir vers ID2 dem Zusatzinfo-Feld der Compiler-Einstellungen-Dialogbox in REALbasic. 


Folgende Elemente werden gespeichert: 


e Hauptversionsnummer im bindr-codierten Dezimalformat. Zugriff tiber die vers-Resource im ersten Byte. 
© Unterversionsnummer im binar-codierten Dezimalformat. Zugriff tiber die vers-Resource im zweiten Byte. 
© Das Release-Stadium. Zugriff tiber die vers-Resource im dritten Byte. 

Die Codierung der Entwicklungsstadien einer Release ist wie folgt: 


Tabelle 46. Werte der Release-Stadien 


Wert Beschreibung 


x20 Entwicklung 
x40 Alpha 

x60 Beta 

x80 Release 


© Pre-Release-Stadium, Zugriff tiber die vers-Resource. 

© Region: Kennzeichnet das Schreibssystem, fiir das die Applikation gedacht ist. Die in der vers-Resource aufbewahr- 
ten Werte werden in der Tabelle 287 auf Seite 401 aufgelistet. 

e Kurze Version: Gibt Auskunft tiber die Version der Software. Es obliegt dem Endbenutzer, ob er sich diese Informa- 
tion in der Listenansicht des Finders anzeigen lassen mochte. 

© Lange Version/Paketinfo: Enthdlt die Versionsnummer und weitere Informationen (Firma, Entwickler, Paket). Ftir 
Dateien mit vers ID1 wird die lange Version im Versions-Abschnitt des Informationen-Fensters im Finders ange- 
zeigt. Fiir Dateien mit vers ID2 wird der String des Zusatzinfo-Feldes im Informationen-Fenster angezeigt. 
Weitere Informationen zur vers-Resource finden Sie unter: 
http://developer.apple.com/techpubs/mac/Toolbox/Toolbox-454.html 
Uber die GetResource-Methode der ResourceFork-Klasse kénnen Sie auf die in der vers-Resource gespeicherten 
Informationen zugreifen. 


Mac OS-Einstellungen 


Unter Mac OS-Einstellungen kénnen Sie: 


© einen Namen fiir Ihre Mac OS 8-9- oder Mac OS X-Applikation festlegen, 
© fiir Mac OS 8/9-Applikationen die minimale und bevorzugte Speichergrée angeben, 
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e zwischen PEF- und Mach-O Format fiir Mac OS X wahlen, 

© einen Creator-Code fiir Ihre Anwendung festlegen und diesen registrieren. Der Creator-Code kann auch iiber eine 
globale Konstante gesetzt werden, sofern diese in einem Modul deklariert oder 6ffentlich zuganglich ist. Dazu ver- 
wenden Sie die Syntax modulname.konstantenname oder fenstername.konstantenname. 


Einstellungen fur Applikation erzeugen 


Erzeuge fir: ww Mac OS X 
Mac OS 8-9 (Classic) 
() Windows 98/NT/2000/XP 


Linux/x86 


Versions-Information a 
Version: (1 }.[o ].[o | 
Release: | Entwicklungsstadium By 


Non-release: 0 


Kurze Version 


Lange Version: 


Zusatzinfo: 
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Creator-Code registrieren 


Der Creator-Code jeder Applikation sollte einzigartig sein, da der Finder iiber den Creator-Code bestimmt, welches Pro- 
gramm bei einem Doppelklick auf ein Dokument geéffnet wird. Der Finder macht die erste Applikation ausfindig, deren 
Creator-Code mit dem Creator-Code des Dokuments tibereinstimmt. 


Um sicherzustellen, dass der Creator-Code Threr Applikation einzigartig ist, konnen Sie ihn bei Apple registrieren lassen. 
Mit Klick auf den Registrieren-Knopf Gffnet REALbasic Ihren Webbrowser und ruft die FAQ-Seite zum Thema Registrie- 
ren von Creator-Codes auf. Die Adresse lautet: 


http://developer.apple.com/dev/cftype/faq.html 


Speichereinstellungen 


Fiir Mac OS Classic-Programme miissen Sie den minimalen und den bevorzugten Speicherbedarf festlegen. Mac OS X 
verwaltet den Speicher dynamisch, deshalb sind diese Einstellungen nicht ftir Mac OS X-Programme relevant. 


Per Voreinstellung tragt REALbasic 4096K als bevorzugte und 2048K als minimale Speicherzuteilung ein. Ist das zu wenig 
oder zu viel? Wie kann man abschitzen, wieviel Speicher eine Applikation ben6tigt? Ganz einfach lasst sich das leider 
nicht sagen. Hinweise zu den Speicheranforderungen Ihrer Applikation erhalten Sie beispielsweise tiber den Befehl 
Uber diesen Computer im Apfel-Menii des Finders (Mac OS 8/9). Sie erhalten eine Liste mit allen aktiven Programmen, 
dem Speicherplatz, der fiir jede Applikation reserviert ist und dem tatsachlich bendtigten Speicherplatz. 


Das Laden von Daten, insbesondere Bildern, erhoht den Speicherbedarf. Wenn Sie die Sprite-Engine verwenden, benoti- 
gen Sie um so mehr Speicher, je mehr Sprites Sie gleichzeitig darstellen méchten. Leider gibt es keine zwingende Logik, 
anhand derer Sie die Speicheranforderungen Ihrer Applikation bestimmen kénnen. Sie miissen experimentieren. Fiih- 
ren Sie Ihre Applikation mit verschiedenen Speichereinstellungen aus, bis Sie eine Einstellung ftir die minimale Spei- 
chergrée gefunden haben, unter der Ihre Applikation korrekt lduft. AnschliefSend korrigieren Sie Ihre Einstellungen in 
der Compiler-Einstellungen-Dialogbox und tiberpriifen das Resultat. 


Je gro8er das Projekt, desto mehr Speicher bendtigt die erzeugte Applikation. Wenn REALbasic eine Stand-Alone-Appli- 
kation nicht erfolgreich erzeugen kann, mtissen Sie REALbasic mehr Speicher zuweisen (nur unter Mac OS 8/9). 
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Kompatibilitatseinstellungen 


Kompatibilitatseinstellungen betreffen nur Mac OS X-Applikationen. REALbasic kann Mac OS X-Applikationen in zwei 
Formaten erzeugen: PEF und Mach-O. PEF-Applikationen konnen auch unter Mac OS 8-9 gestartet werden, sofern die 
CarbonLib installiert ist. Mach-O-Applikationen laufen nur unter Mac OS X. 


Die PEF-Struktur speichert Programme im Format der Code-Fragment-Manager-basierten Laufzeitarchitektur. Mach hin- 
gegen ist das Format des Unix-Kernels, der Mac OS X zugrunde liegt und Mach-O sind entsprechende Objekt-Dateien. 
Mach-O ist das native Mac OS X-Format und wird von Apple bevorzugt. Kommandozeilen-Applikationen konnen nur im 
Mach-O-Format, Desktop-Applikationen in beiden Formaten erzeugt werden. 


Windows-Einstellungen 


Unter Windows-Einstellungen legen Sie den Programmnamen der Windows-Version Ihrer Applikation fest. Sie konnen 
bestimmen, ob Thre Applikation als Multiple Document Interface-Applikation (MDI) laufen soll. Die entsprechende 
Checkbox legt fest, dass die Applikation in einem MDI-Fenster ausgefiihrt wird. Wenn Sie sich fiir diese Option entschei- 
den, k6nnen Sie den Titel des MDI-Elternfensters vorgeben. MDI bedeutet, dass alle Fenster Ihrer Applikation in einem 
iibergeordneten Fenster (Elternfenster) erscheinen. 
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Erzeuge fiir: Mac OS X 
C) Mac OS 8-9 (Classic) 
() Windows 98/NT/2000/XP 


LU Linux/x86 


Windows-Einstellungen iz 


Programm-Name: /Mein Programm.exe 


{> Multiple Document Interface 


Fenstertitel: Mein Programm 


( Icons...) (_ Abbrechen ) —_—a— 


Wenn Sie Multiple Document Interface nicht anwahlen, erscheinen die Fenster Ihrer Applikation neben den Fenstern 
anderer offener Windows-Anwendungen und haben eigene Meniis. Wenn Ihre Applikation mehr als ein Fenster aufrufen 
kann, startet sie sich dazu einfach ein weiteres Mal. 

Mit Hilfe der MDIWindow-Klasse konnen Sie diverse Eigenschaften des iibergeordneten MDI-Elternfensters bestimmen, 
so zum Beispiel Ausgangsgrde und Ausgangsposition, Mindestgrdfe und Titel. Weitere Informationen zur 
MDIWindow-Klasse finden Sie in der Sprachreferenz. 
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Linux-Einstellungen 
Hier konnen Sie Ihrer Linux-Applikation einen Namen geben. 


Einstellungen fiir Applikation erzeugen 


Erzeuge fiir: w Mac OS X 
Mac OS 8-9 (Classic) 
(Windows 98/NT/2000/XP 


) Linux/x86 


Linux/x86 Settings iz) 


(icons... ) ( Abbrechen ) or 
cc ___——_ cc ___ 


Compiler-Einstellungen 
Im letzten Panel konnen Sie einstellen, ob die erzeugten Applikationen Funktionsnamen enthalten sollen. Diese konnen 


zu Debugging-Zwecken verwendet werden. 
Einstellungen fiir Applikation erzeugen 


Erzeuge fiir: w Mac OS X 
_) Mac OS 8-9 (Classic) 
(Windows 98/NT/2000/XP 
C Linux/x86 


Compiler-Einstellung... i) 


— Funktionsnamen fiir die Verwendung beim 
— Debuggen und der Performance-Tools hinzufiigen. 
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Individuelle Icons fiir Ihre Applikation 


Uber die Compiler-Einstellungen-Dialogbox kinnen Sie Ihrer Applikation ein individuelles Icon zuweisen (dies funkti- 
oniert nur, wenn Ihre Anwendung einen eigenen Creator-Code besitzt). Kicken Sie dazu auf den Icons. ..-Knopf. 


Klicken Sie hier, um die 


Programm-Icon-Dialogbox PCr.) Sapa 


aufzurufen. 


Im folgenden Dialog k6nnen Sie Icons mit verschiedenen Grdfen und Farbtiefen tiber die Zwischenablage einftigen. 


Das Programm erzeugen 395 


Abb. 282: Die Programm-Icon-Dialog 
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Sie kénnen auch Icons léschen und von einem Resource-Typ in einen anderen kopieren. Die GroSenanpassung erfolgt 
dabei automatisch. Elemente folgender Typen kGnnen tiber die Zwischenablage eingeftigt werden: icns, icl8, ICN#, 
ics8, ics#, icm#, icm8 und PICT. Weisen Sie Ihrer Applikation ein individuelles Icon zu, indem Sie es in der passenden 
Farbtiefe und Gréfe in diesen Dialog einfiigen. Um wieder zu den Standard-Icons zuriickzukehren, klicken Sie auf 
Voreinstellungen. Nachdem Sie eine Auswahl getroffen haben, bestatigen Sie diese mit OK. 


Damit wird das ,,custom icon bit“ fiir Ihre Applikation gesetzt, so dass fiir diese im Finder ein 32-Bit-Farbicon angezeigt 
wird, auch wenn Sie keinen Creator-Code festgelegt haben. Falls Sie Ihr Programm ver6ffentlichen wollen, empfehlen 
wir Ihnen, einen Creator-Code bei Apple zu registrieren. 


Hinweis: Mac OS-Versionen < 8.5 unterstiitzen weder 32-Bit Icons noch 128x128 Pixel- und 48x48 Pixel-Icons. 


Eine alternative Méglichkeit, Ihrer Applikation individuelle Icons zuzuweisen besteht darin, die Dateiinformation des 
Icons (inklusive 32-Bit ,,icns“-Icons) in eine Resource-Datei zu packen und diese in Ihr Projekt einzufiigen. Dieses Icon 
ersetzt dann das im Programm-Icon-Dialog festgelegte. 


Eine Anwendung zum Compilieren vorbereiten 


Auch wenn es sehr einfach ist, eine Stand-Alone-Applikation zu erzeugen, sollten Sie dennoch die Besonderheiten und 
Einschrankungen der jeweiligen Zielplattform berticksichtigen, um die Leistungsfahigkeit Ihrer Applikation zu optimie- 
ren. Der folgende Abschnitt befasst sich mit diesem Thema. 


REALbasic bietet mit Remote Debugging eine komfortable Méglichkeit, Applikationen auf anderen Plattformen zu tes- 
ten. Wenn Sie einen zweiten Computer besitzen, auf dem ein anderes Ziel-Betriebssystem lauft, kann der 
Remote-Debugger eine Testversion Ihres Programms auf diesen tibertragen und dort starten. 


Weitere Informationen dazu finden Sie im Abschnitt ,,Remote Debugging“ auf Seite 364. 


Fir Windows compilieren 


Um ein Programm fiir Windows zu erzeugen, miissen Sie in den Compiler-Einstellungen lediglich die Checkbox 
»Erzeuge fiir Windows...“ aktivieren und dem zu erzeugenden .exe-File im Bereich ,Windows-Programmeinstelllungen“ 
einen Namen geben. 


Auf dem Macintosh bekommt die Windows-Applikation ein Virtual PC™-Icon. Falls Virtual PC installiert ist, konnen Sie 
auf die erzeugte Windows-Applikation einen Doppelklick ausftihren, um Virtual PC zu starten und die Applikation zu off- 
nen. Wenn Sie die .exe-Datei auf einen Windows-Rechner oder in ein Virtual PC-Verzeichnis kopieren, hat sie das Stan- 
dard-REALbasic-Icon. 
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Besonderheiten bei Windows-Programmen 


Fir jede erzeugte Windows-Anwendung sollten Sie aus Kompatibilitatsgriinden folgende Punkte priifen: 


Zeilenendezeichen: Wenn Sie Texte in EditFields per Code eintragen, muss einem Carriage Return ein Line Feed fol- 
gen. Benutzen Sie dazu die EndOfLine-Funktion anstatt der Steuerzeichen selbst. 
Nicht-ASCII-Zeichen: Zeichen mit ASCII-Codes gr6fer 127 unterscheiden sich unter Mac OS und Windows und je 
nach Sprache. Beispielsweise hat der Aufzahlungspunkt ,,*“ unter Mac OS den Wert 165, unter Windows 149. Wenn 
Sie Text aus einer fremden Quelle lesen, k6nnen Sie bei den Methoden Read, ReadLine und ReadAll optional die 
Codierung angeben. REALbasic speichert die Codierung intern. Wenn Sie Text in einer bestimmten Codierung schrei- 
ben wollen, konvertieren Sie den Text vor dem Schreiben mit der ConvertEncoding-Methode. 
MDI Interface: Die Grofse des MDI-Rahmens (des Elternfensters) ist derzeit nicht konfigurierbar. Dies sollten Sie 
bedenken, wenn Sie die Gro&e eines Fensters festlegen, das Sie offnen mochten. 
Windows GUI: Halten Sie sich an die Windows-User-Interface-Richtlinien. Andernfalls sieht Ihre Applikation wie eine 
Portierung vom Mac auf Windows aus und nicht wie eine richtige Windows-Applikation. 
Interface-Elemente: Viele Windows-Interface-Elemente unterscheiden sich vom Macintosh. Ein in der Gréfe verin- 
derbares Dokumentfenster hat auf dem Mac z.B. einen VergroSerungsknopf. Unter Windows existiert dieser nicht. 
Wenn ein Steuerelement wegen seiner Positionierung das Vorhandensein eines VergroSerungsknopfes voraussetzt, 
wird es unter Windows nicht korrekt aussehen. 
Reihenfolge der Steuerelemente: Die Reihenfolge der Steuerelemente ist unter Windows wichtiger, da dort auch 
CheckBoxes und PushButtons den Fokus bekommen kénnen. Testen Sie daher die Reihenfolge der Steuerelemente 
unter Windows, bevor Sie Ihre endgiiltige Applikation erzeugen. 
Multiple Document Interface: Viele MDI-Applikationen unter Windows maximieren den MDI-Rahmen, wenn sie 
gestartet werden. Das MDI-Rahmenfenster ist das Elternfenster, in dem die Fenster der Applikation gedffnet werden. 
Wenn Sie eine Win32-Version Ihres REALbasic-Projekts compilieren und wollen, dass das MDI-Rahmenfenster beim 
Start maximiert wird, fligen Sie folgenden Code in den Open-Event Ihrer Application-Klasse ein: 
Dim result as Integer 
CONST SW_MAXIMIZE = 3 
Declare Function ShowWindow Lib "user32" Alias "ShowWindow" 

(ByVal hwnd As Integer, ByVal nCmdShow As Integer) As Integer 
Declare Function GetActiveWindow Lib "user32" 

Alias "GetActiveWindow" As Integer 
result = ShowWindow(GetActiveWindow(), SW MAXIMIZE) 
Hinweis: Wenn Sie keine Application-Klasse in Ihrem Projekt haben, wahlen Sie den Mentipunkt Ablage/Neue 
Klasse, stellen Application als Super-Eigenschaft der neuen Klasse ein und nennen Sie App. 
Mac-spezifische Steuerelemente: Einige Steuerelemente (wie die ChasingArrows) gibt es nur auf dem Mac und haben 
unter Windows kein Pendant. Obwohl REALbasic eine Windows-Version dieser Steuerelemente anbietet, sollten Sie 
sich tberlegen, ob diese in der Windows-Version Ihrer Applikation passend sind oder nicht. Die Toolbar-Steuerele- 
mente sind nur unter Mac OS X 10.2 und hoher verftigbar. Wenn Sie diese verwenden, bendtigen Sie alternative Ele- 
mente ftir die anderen Plattformen. 
IsCMMClicked Funktion: Diese Funktion liefert True, wenn der Anwender die rechte Maustaste driickt. Sie funktio- 
niert nur unter Windows und bei Steuerelementen, die einen Mousedown-Event-Handler besitzen. 
Windows-Meniis: Einige Standard-Meniis sind unter Windows anders benannt als unter Mac OS. Dieses Problem kén- 
nen Sie in REALbasic elegant mit Konstanten ldsen. Mehr dazu im Abschnitt ,Lokalisieren einer Applikation mit Hilfe 
von Konstanten“ auf Seite 208. 
Mac-spezifische Funktionen: Einige Fahigkeiten von REALbasic stehen nur unter Mac OS zur Verfiigung, z.B. Apple- 
Events und AppleScript, Resource-Dateien und Shared Libraries. Mittels bedingter Compilierung kGnnen Sie Pro- 
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grammteile beim Erzeugen einer Windows-Anwendung ausblenden, die nur ftir den Mac relevant sind. Bedingte 
Compilierung verwendet folgendes Konstrukt: 
#1f TargetBoolean then 
//Plattformspezifischen Code hier einfligen 
#Elseif TargetBoolean2 then 
//Plattformspezifischen Code fiir Plattform TargetBoolean2 hier einftigen 

d#Endif 
TargetBoolean ist eine boole’sche Konstante oder ein boole’scher Ausdruck und erméglicht es Ihnen, den folgenden 
Code nur fiir diesen speziellen Fall einzubinden. Folgende Konstanten stehen zur Auswahl: TargetMacOS, 
TargetMachO, TargetPPC, TargetCarbon, TargetLinux und TargetWin32. Mit Hilfe dieser Konstanten testen Sie, fiir wel- 
che Plattform die Applikation momentan erzeugt wird. Sie konnen auch Ausdriicke verwenden, die True oder False 
zurtickgeben. Beispielsweise konnen Sie mit RBVersion feststellen, welche REALbasic-Version verwendet wird. Mehr 
dazu finden Sie unter ,,Cross-Plattform-Entwicklung* in der Sprachreferenz. 

© Mac-spezifische Folderltems: Einige Funktionen, die Verweise auf Mac OS-spezifische Ordner zuriickliefern, liefern 
unter Windows oder Linux Nil oder ein Folderltem zuriick, das nicht dem entspricht, was Sie erwarten. Ist dies der 
Fall, kGnnen sie mithilfe des #ifAusdrucks die Plattform priifen, fiir die die Applikation momentan erzeugt wird. 

© ‘oolbox-Aufrufe: Mit der Declare-Anweisung konnen Sie direkte Toolbox-Aufrufe fiir die Macintosh- oder die Win- 
dows-Plattform ausftihren. Natiirlich unterscheiden sich die Toolbox-Funktionen auf den verschiedenen Plattformen. 
Benutzen Sie auch hier die bedingte Compilierung, um die Declare-Anweisungen und Toolbox-Aufrufe fir die ver- 
schiedenen Plattformen voneinander zu isolieren. 

© Datenbank-Datenquellen: Unter Windows stehen derzeit nur der ODBC-Datenbanktreiber und die integrierte 
REAL-Datenbank zur Verfiigung. 

© Schrifigropen fiir Steuerelemente: Die drei Plattformen, die von REALbasic unterstiitzt werden, haben ihre eigenen 
Vorgaben beziiglich standardmafsig vorhandener Systemzeichensatze und Schriftgr6&en. Oftmals sieht ein Zeichen- 
satz auf der einen Plattform gut aus, auf der anderen ist er jedoch zu gro oder zu klein. Aus diesem Grund besitzt 
die Einstellungen-Dialogbox eine Option, um die Schriftgr6en-Voreinstellung des Ziel-Betriebssytems als Standard- 
schriftgr68e fiir alle Steuerelemente auszuwahlen, die Text verwenden. Diese Option erlaubt es Ihnen, gleichzeitig 
mehrere voreingestellte Schriftgr6&en fiir Steuerelemente auszuwahlen. Wahlen Sie eine Schriftgré8e von null, um 
von dieser Option Gebrauch zu machen. 


Abbildung 283. Auswahl der voreingestellten SchriftgroSe des jeweiligen Systems ftir Steuerelemente 
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Was Sie bei Anwendungen fiir Mac OS X beachten sollten 


Nachdem Sie Ihre Applikation ftir Mac OS X erzeugt haben, sollten Sie bei allen Interface-Elementen testen, ob sie die 
richtige Grose haben und die Beschriftungen korrekt angezeigt werden. AufSerdem muss jede Shared Library, die die 
Applikation verwendet, carbonisiert sein. 
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Windows-Anwender sollten sich mit den Aqua Human Interface Guidelines von Apple vertraut machen. Es handelt sich 
dabei um Empfehlungen von Apple zur Gestaltung von Benutzeroberflichen. Die Guidelines finden Sie unter: 


http://developer.apple.com/techpubs/macosx/Essentials/AquaHIGuidel ines/ 


Im folgenden werden einige grundlegende Unterschiede zwischen Windows und der Benutzeroberflache des Macintosh 
behandelt. Einige Unterschiede lassen sich mit sorgfaltigem Design der Benutzeroberflache tiberbriicken. Andere hinge- 
gen erfordern alternative Versionen von Fenstern, Dialogen und anderen Elementen der Benutzeroberflache. Um die 
verschiedenen Versionen eines Objekts zu verwalten, konnen Sie den #Jf-Ausdruck einsetzen. So konnen Sie Ihr Pro- 
gramm zielplattformabhangig compilieren. Information zum bedingten Compilieren finden Sie in der Sprachreferenz. 


© Auf dem Macintosh gibt es nur eine Meniileiste, die sich immer am oberen Bildschirmrand befindet. Fenster haben 
keine eigenen Meniileisten. Auch wenn REALbasic den Einsatz von mehrerer Meniileisten fiir verschiedene Fenster 
unterstiitzt, steht dies nicht im Einklang mit Apples Richtlinien fiir die Gestaltung von Benutzeroberflachen. 

© Der Windows-Mentipunk Datei heifst auf dem Macintosh Ablage. Fiir Probleme dieser Art bietet REALbasic eine ele- 
gante Losung. Mehr dazu im Abschnitt ,,Lokalisieren einer Applikation mit Hilfe von Konstanten“ auf Seite 208. 

© Unter Mac OS X befindet sich der Einstellungen-Mentipunkt fiir allgemeine Programmeinstellungen im Applikations- 
menii, nicht im Datei-, Ablage-, Optionen- oder Werkzeugmenii. In REALbasic gibt es eine spezielle Klasse, die sich 
dieses Problems annimmt: die PrefsMenultem-Klasse. Verwenden Sie diese Klasse an Stelle der Menultem-Klasse ftir 
den Mentipunkt Einstellungen. 

e Der Macintosh bietet keine Unterstiitzung fiir das Multiple Document Interface von Windows. Unter Mac OS X liegt 
jedes Fenster auf einer eigenen Ebene. Das bedeutet, dass mit Klick auf ein Fenster nicht gleichzeitig alle anderen 
Fenster der Anwendung in den Vordergrund kommen. Wenn Sie Ihre Applikation als MDI-Applikation entworfen 
haben, sollten Sie sie unbedingt auch unter diesem Gesichtspunkt erproben. 

© Die Apple-Maus hat standardmafig nur einen Mausknopf, wenngleich auch zahlreiche Losungen mit mehreren Maus- 
knépfen von Drittanbietern auf dem Markt erhiltlich sind. Das Aquivalent zum Rechtsklick unter Windows ist auf 
dem Macintosh der Ctrl-Klick. Stellen Sie sicher, dass Ihre Applikation keine Mausfunktionen voraussetzt, die mit der 
Eintastenmaus des Macs nicht moglich sind. 

© Unter Mac OS X dient das Dock dazu, Applikationen und Dokumente zu starten. Uber die Dockltem-Eigenschaft der 
Application-Klasse konnen Sie das Programmsymbol im Dock manipulieren. Uber die Dockltem-Eigenschaft der Win- 
dows-Klasse kénnen Sie das Erscheinungsbild eines Dokuments im Dock manipulieren (Wenn ein Benutzer unter 
Mac OS X ein Dokumentfenster minimiert, erscheint es als Icon im Dock). Die Icons sollten 128x128 Pixel grofs sein. 

© Die Knépfe in Dialogboxen verwenden Verben statt ,,Ja“ oder Nein“ und sind anders angeordnet. Oft ist die Reihen- 
folge des Abbrechen- und Bestatigen-Knopfes im Vergleich zu Windows genau vertauscht. Unten sehen Sie typische 
Dialoge zum Sichern von Anderungen unter Mac OS X und Windows XP. Es bestehen wesentliche Unterschiede 
beztiglich Beschriftung und Anordnung der Knépfe. 


Abb. 284: ,, Anderungen speichern”-Dialoge unter Mac OS X und Windows XP 
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© Apple rat von Werkzeugleisten mit vielen kleinen Icons ab und empfiehlt den Einsatz einiger weniger, qualitativ hoch- 
wertiger und groferer Icons. Die Icons sollten beschriftet sein. Solche Werkzeugleisten konnen mit Hilfe der Toolbar- 
Item- und der StandardToolbarltem-Klassen erzeugt werden. Mac OS X-Applikationen verwenden auferdem 
Schubladenfenster, um beim Klick auf ein Icon der Werkzeugleiste weitere Auswahlméglichkeiten anzubieten. Apple 
empfiehlt auch den Einsatz schwimmender Paletten als Alternative zu sehr umfangreichen Werkzeugleisten. 
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e Auf dem Macintosh gibt es einige standardmafig reservierte Tastaturktirzel. Sie sollten diese nicht mit Ihrer Applika- 
tion tiberschreiben. Die Aqua User Interface Guidelines empfehlen auch Tastaturkiirzel fiir haufig ausgeftihrte Opera- 
tionen, wie z.B. flir die Eintrage des Datei- und Bearbeiten-Meniis. 

e@ Wahrend Mac OS X und Windows aus der Endung (dem Suffix) einer Datei auf deren Inhalt schlie&en, verwendet 
Mac OS 8/9 dafiir so genannte Typ- und Creator-Codes. Sollen Dokumente, die mit Ihrer Applikation erzeugt wurden, 
unter Mac OS Classic verwendet werden, miissen Sie solche Codes erzeugen und bei Apple registrieren. 

© Carbon-Applikationen beinhalten eine automatisch generierte ,,plst“-Resource. In dieser sind die Informationen ent- 
halten, die in alteren Mac OS-Versionen in den ,vers‘-, ,open‘-, ,FREF“-, ,BNDL*- und ,,kind“-Resourcen zu finden 
waren. Wenn Mac OS X in einem Programm eine ,,plst-Resource findet, verwendet es diese an Stelle der ,,alten“ 
Resourcen. Sie konnen die automatisch erzeugte ,plst“ 0-Resource tiberschreiben, indem Sie eine eigene erzeugen, 
in einer Resource-Datei ablegen und diese in Ihr Projekt einftigen. 


Anmerkungen zu Linux-Applikationen 
Wenn Sie Applikationen ftir Linux erzeugen wollen, sollten Sie die folgenden Informationen beachten. 


Anforderungen 


Von REALbasic erzeugte Linux-Applikationen laufen nur auf x86-Computern und benétigen GTK+ 2.0 (was weitere 
Pakete wie GDK, Pango, Atk etc. voraussetzt). Sie kinnen die GIK+ 2.0 Bibliotheken unter http://www.gtk.org herun- 
terladen. Eventuell finden Sie beim Hersteller Ihrer Distribution eine vorcompilierte Version. 


Grundsatzliche Informationen 
Einige Steuerelemente, die unter Mac OS X und Windows funktionieren, sind unter Linux nur eingeschrankt nutzbar. 


© RB3DSpace: Das RB3DSpace-Steuerelement bendtigt OpenGL. 

© Sounds: Benétigen libsndfile (http://www.zip.com.au/~erikd/ibsndfile/). Durch ,weak linking“ funktioniert die 
Applikation aber auch, wenn diese Bibliothek nicht installiert ist. Sounds werden dann nicht abgespielt. 

© Canvas: Scrollen fiihrt dazu, dass der gesamte Canvas-Inhalt neu gezeichnet wird, falls das Canvas von einem anderen 
Steuerelement tiberlagert wird. 

© Drag&Drop: Beim Draggen tiber Steuerelemente, die einen Mouse-Over-Effekt haben (wie PushButtons) wird die 
Bound-Eigenschaft nicht aktualisiert. 

@ EditField: SelCondense, SelExtend, SelOutline und SelShadow werden nicht unterstiitzt. 

@ Folderltem: Das Erstellungsdatum eines Folderltems kann nicht gesetzt werden. 

© Meniis: Zwei Fenster k6nnen nicht auf das gleiche Meniti verweisen. Wenn zwei Fenster das gleiche Menti verwenden 
sollen, miissen das Menti duplizieren. 

© MoviePlayer und QuickTime-basierte Klassen werden derzeit nicht unterstiitzt. 

e PushButton, CheckBox und RadioButton: Der ,,gedriickt“-Status dieser Steuerelemente kann nicht unterdriickt wer- 
den, wenn der MouseDown-Event True liefert. 

© Scrollbars verhalten sich anders als in Mac OS X und Windows. Wenn Sie in einen der Pfeilkndpfe klicken, ohne dass 

LiveScroll aktiv ist, wird der ValueChanged-Event erst ausgeldst, wenn Sie den Mausknopf loslassen. 

Speak: Die Speak-Methode wird in diesem initialen Release nicht unterstiitzt. 

RadioButtons: In einer Gruppe von RadioButtons muss immer einer ausgewahlt sein. 

Popup-Meniis: Separatoren werden nicht unterstiitzt. 

NotePlayer: Der NotePlayer wird in diesem initialen Release nicht unterstiitzt. 

Drucken: Zum Drucken wird die Bibliothek libgnomeprint 2.2 (oder hdher) benotigt. Zusatzlich muss CUPS instal- 

liert sein. Es kann nur auf Postscript-Druckern gedruckt werden. Unter Linux gibt es keinen Papierformat-Dialog. Der 

Aufruf der PrinterSetup-Methode liefert False zuriick und es wird kein Dialog angezeigt. 
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Vorgabesprache 


Wenn Sie Ihr Projekt mit Hilfe von Konstanten so organisiert haben, dass Sie verschiedensprachige Versionen erzeugen 
k6nnen, ist es mdglich, die Vorgabesprache ftir den nachsten Compilerdurchlauf im Sprache-Popup auszuwahlen. Die 
Default-Sprache ist die, die bei den Projekt-Einstellungen eingestellt wurde. Mehr zu diesem Thema finden Sie im 
Abschnitt ,,Lokalisieren einer Applikation mit Hilfe von Konstanten“ auf Seite 208. 


Dokument-Icons 


Wie Sie Ihrem Programm ein eigenes Icon geben kénnen, wurde weiter vorn bereits erklart. 


Unter Bearbeiten/Dateitypen konnen Sie auch den von Ihrem Programm erzeugten Dokumenten eigene Icons zuord- 
nen. Offnen Sie dazu den Dateitypen-Dialog und fiihren Sie einen Doppelklick auf den gewtinschten Dateityp aus. 


Abb. 285: Dateityp mit Dokument-Icon in der Dateitypen-Dialogbox: 


Dateityp hinzufiigen 


Name: |}mage/x-pict | @ 


Mac-Creator: 777? ) Mac-Typ: PICT 
Extension: .Mac;.pct;.pic;.pict 


M Dokument-icon: Icon 


Klicken Sie dann auf den Icons-Knopf. Damit rufen Sie die Dokument-Icons-Dialogbox auf: 


Abb. 286: Die Dialogbox zum Festlegen von Dokument-Icons 
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Hier k6nnen Sie analog zum Vorgehen bei Programm-Icons (siehe Seite 394) aus der Zwischenablage Icons in verschie- 
denen Gr6fsen und Farbtiefen einftigen. 


Mehrere Benutzer unter Mac OS 9 


Unter Mac OS 9 kénnen Sie iiber das Kontrollfeld ,Mehrere Benutzer“ verschiedene Benutzer anlegen und diesen den 
Zugriff auf alle Applikationen oder nur auf bestimmte Programme erlauben. Wenn einem Benutzer, dem Sie das Verwen- 
den einer mit REALbasic geschriebenen Anwendung gestattet haben, trotzdem der Zugriff verweigert wird, liegt das 
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daran, dass sich das Betriebssystem die Zugriffsrechte fiir Applikationen tiber deren Creator-Code merkt. Ihre Applika- 
tion bendtigt also einen Creator-Code, damit sie unter Mac OS 9 korrekt mit ,Mehrere Benutzer“ zusammenarbeitet. 


Der Thread-Manager 


Die REALbasic-Entwicklungsumgebung benotigt einen installierten Thread-Manager. Das aus Ihrem Projekt erzeugte 
Stand-Alone-Programm wiederum benotigt nur dann einen Thread-Manager, wenn Sie Unterklassen verwendet haben, 
die aus der Thread-Klasse abgeleitet wurden. 


Landercodes 


Folgende Tabelle zeigt die Landercodes, die in der ,,vers“-Resource einer erzeugten Applikation verwendet werden: 


Abb. 287: Lander-Codes, die in der ,,vers”-Resource verwendet werden: 


Code Wert Code Wert 
00 US 22 alta 
01 France 23 Cyprus 
02 Britain 24 Turkey 
03 Germany 25 Yugoslavia 
04 Italy 33 ndia 
05 Netherlands 34 Pakistan 
06 Belgium-Lux. 36 t. Swiss 
07 Sweden 40 Anc. Greek 
08 Spain 41 Lithuania 
09 Denmark 42 Poland 
0 Portugal 43 Hungary 
| Fr. Canada 44 Estonia 
2 Norway 45 Latvia 
3 Israel 46 Lapland 
4 Japan 47 Faeroe Isl. 
5 Australia 48 ran 
6 Arabia 49 Russia 
7 Finland 50 reland 
8 Fr. Swiss 51 Korea 
9 Gr. Swiss 52 China 
20 Greece 53 Taiwan 
21 Iceland 54 Thailand 
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xpitelis Visual Basic-Projekte portieren 


Weil es sehr viele Gemeinsamkeiten von REALbasic und Visual Basic gibt, ist es relativ einfach, aus einem Visual Basic 
Projekt eine Macintosh-Version unter REALbasic zu erzeugen. 


Inhalt 


© Importieren von Forms und Code 

© Tipps, die die Konvertierung erleichtern 
© Der VB Project Konverter 

© Datenbank-Anbindung 


Importieren von Forms und Code 


REALbasic kann Forms von Visual Basic 2.0 (oder neuer) importieren und den dazugehorenden Code. REALbasic baut 
das Interface dazu neu zusammen und importiert den Code, der den einzelnen Steuerelementen zugeordnet ist, in die 
entsprechenden Event-Handler und Methoden. 

Um VB-Forms zu importieren, gehen Sie folgendermafsen vor: 

1. Optional ftir Macintosh-Anwender: Kopieren Sie die VB-Forms-Dateien (diese enden mit .frm) auf den Macintosh. 

2. Offnen Sie ein neues oder ein existierendes REALbasic-Projekt. 

3. Ziehen Sie die Forms-Dateien vom Desktop in das Projektfenster, um sie zu importieren. 

Weil es zwischen REALbasic und Visual Basic Unterschiede gibt, werden Fehler auftreten, die Sie zundchst korrigieren 


miissen. Nach dem Import der Forms-Dateien starten Sie dazu das Projekt, um dann nach und nach die aufgetretenen 
Probleme zu beheben. 


Vereinfachen der Konvertierung 


Es gibt ein paar MafSnahmen, die Sie ergreifen konnen, um im Vorfeld die Konvertierung von Visual Basic-Projekten nach 
REALbasic zu erleichtern. REALbasic wird mit einem Tool names VB Project Converter (VBPC) ausgeliefert, das die Kon- 
vertierung erleichert. Um ein Projekt zu konvertieren, ziehen Sie das VB-Projekt auf das VB Project Converter-Programm. 
Es werden automatisch alle Dateien, die zum Projekt gehoren, eingelesen (diese miissen sich im selben Verzeichnis wie 
die Projektdatei selbst befinden). Formular-Ressourcen (*.frx-Dateien) mtissen sich im selben Verzeichnis wie das zuge- 
hdrige Formular befinden. Es ist nicht notwendig, *.frx-Ressource-Dateien manuell hinzuftigen. Diese werden bei Bedarf 
vom VB Project Converter eingelesen. 


Sie konnen die Dateien deselektieren, die nicht in Ihr REALbasic-Projekt tibernommen werden sollen. 


Bekannte Probleme 


Die folgenden Probleme betreffen Unterschiede in der Architektur von VB und REALbasic. 


e Steuerelemente: Falls ein Steuerelement in REALbasic nicht untersttitzt wird, konvertiert VBPC es in ein Canvas-Steu- 
erelement. VB-Views oder VB-Steuerelemente, die als Container fiir andere Steuerelemente dienen, kann VBPC nicht 
konvertieren, da der Parser dieser VBPC-Version ineinander verschachtelte Elemente nicht unterstiitzt. 
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Falls Sie in Ihrem VB-Projekt MonthView-Steuerelemente verwenden, werden diese durch ckMonthView-Can- 
vas-Steuerelemente ersetzt. ckMonthView dhnelt im Wesentlichen dem Erscheinungsbild und der Funktionalitat des 
VB-MonthView-Steuerelements. 

e Meniis: Meniis werden nur in Formularen unterstiitzt. REALbasic unterstiitzt auser dem Standard-Tastaturktirzel nur 
die Wahl- und die Shifttaste. Funktionstasten werden durch die Nummer der Taste ersetzt. Die Loschen-Taste 
(Delete) wird durch ein ,,D“ ersetzt, die Einftigen-Taste (Insert) durch ein ,I, die Backspace-Taste durch ein ,,B“. Jede 
andere Spezialtaste wird entfernt. 

e@ MDI: VBPC unterstiitzt noch keine MDI-Projekte, an der Unterstiitzung von MDI wird aber gearbeitet. In REALbasic 
wird die MDI-Unterstiitzung mit einer MDI-Klasse und nicht mit einem Container realisiert. In REALbasic ist es nicht 
moglich, Steuerelemente im MDI-Elternfenster zu verwenden. 

© Icons: Ein Icon wird als Bild importiert und enthalt das eigentliche Bild und eine Maske. 

© Konstanten: VBPC versucht den Datentyp einer Konstanten zu erraten. Sie miissen beim Offnen eines konvertierten 
Projekts in REALbasic den Datentyp jeder Konstante tiberpriifen. 

© Datenbank: VBPC bietet (derzeit) nur eine eingeschrinkte Datenbankunterstiitzung. ADAO- und DAO-Steuerele- 
mente werden Ihrem Projekt hinzugeftigt. Da VBPC Ihrem Projekt keine Datenbank zuordnen kann, ist bei Steuerele- 
menten, die mit einer Datenbank verbunden sind, zwar die DataField-Eigenschaft korrekt gesetzt, nicht aber die 
DataSource-Eigenschaft. Um eine MS Access-Datenbank in eine REAL-Datenbank zu konvertieren, sollten Sie sich 
den Access Converter von Jose Cuevas ansehen. Datadesigners, Crystal Reports und ahnliche Produkte werden nicht 
unterstutzt. 


Datenbank-Anbindung 


Visual Basic-Programme benutzen oft die Microsoft Access- (oder Jet-) Datenbank-Engine. REALbasic Standard und Pro- 
fessional verfiigt tiber eine eingebaute Datenbank-Engine und eine Plugin-Schnittstelle fiir weitere Datenbanksysteme, 
die Sie verwenden k6nnen, um Datenbankapplikationen zu portieren. 
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